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assumes no pnor programming expen- 

It shows how all the 

basic data types and control statements are used traditionally. The book then progresses to the object-ori- 


ence. 




be used in a first programming course for college students. By careful choice of exercises and supplemental 
material it could be used for a gentle introduction to progra mmin g for computer science or engineering 
majors also. 


The second half of the book explains in detail much that is sophisticated about Java, such as its threading, 
excetion handling, graphical ( user interface (GUI), generics, and file manipulation capabilities. As such the 
book is suitable as the primary text in an advanced progr ammin g course, or as a supplementary text in a 
course on data structures, software methodology, comparative languages, or other course in which the 



Java, invented at Sun Microsystems in the mid-1990s, is a powerful modem successor language to C and C++. 
Java, like C++, adds to C the object-oriented programming concepts of class , inheritance and run-time type 
binding. The class mechanism provides user-defined types also called abstract data types. While sharing 
many syntactic features with C and C++, Java adds a number of improvements, including automatic memory 
reclamation called garbage collection , bounds checking on arrays, and strong typing. In addition, the stan¬ 
dard Java libraries, called packages in Java, provide platform independent support for distributed program¬ 
ming, multi-threading and graphical user interfaces. 



to C, unlike C++, Java is not a superset of C. This has 
allowed the creators of Java to make a number of syntactic improvements that make Java a much safer pro¬ 
gramming language than C. As a result, Java is much better as a first progr amming language. 


Java by Dissection:2ed begins with a classical programming style starting with programs as a simple 
sequence of instructions, then adding in control flow and functional abstraction. After that comes arrays and 
data abstraction using classes, which can be covered in either order - arrays first, or data abstraction with 
classes first. Then comes the material on inheritance and graphical user interfaces. Again, the chapter on 
inheritance can be covered before or after the first chapter on graphical user interfaces. Finally come the 
advanced chapters. The following figure illustrates the flexibility in the order in which the material can be 
covered. 












































































































































































































1: introduction 
2: Fundamentals 
3: Control Flow 

I 

4: Methods 



The book emphasizes working code. One or more programs particularly illustrative of the chapter’s themes 
are analyzed by dissection, which is similar to a structured walk-through of the code. Dissection explains to 
the reader newly encountered programming elements and idioms. 

Because Java includes a relatively easy-to-use, standard package for creating graphical user interfaces, it is 
possible to introduce the use of GUIs in a beginning programming book. Creating programs with GUIs is as 
fundamental today as being able to create nicely formatted text output. To fully under stand the GUI pack¬ 
ages in Java, it is necessary to have some understanding of OOP and inheritance. The main chapters on GUI 
building immediately follow the chapters on objects and inheritance. For those students interested in getting 
an early exposure to some of the graphical aspects of Java, we have provided a series of extended exercises at 
the end of the early chapters, that introduce GUIs and applets. These exercises provide templates for some 
simple applets, without providing complete explanations of some of the language features required. 

The following summarizes the primary design features that are incorporated into this book. 


Dissections. Each chapter has several important example programs. Major elements of these programs are 
explained by dissection. This step-by-step discussion of new programming ideas helps the reader encounter¬ 
ing these ideas for the first time to understand them. This methodology has been proven effective in numer¬ 
ous progr ammin g books since its first use in A Book on C in 1984. 

Teaching by Example. The book is a tutorial that stresses examples of working code. Right from the start the 
student is introduced to full working programs. Exercises are integrated with the examples to encourage 
experimentation. Excessive detail is avoided in explaining the larger elements of writing working code. Each 
chapter has several important example programs. Major elements of these programs are explained by dissec¬ 
tion. 

Object-Oriented Programming (OOP). The reader is led gradually to an understanding of the object-oriented 
style. Objects as data values are introduced in Chapter 2, Program Fundamentals . This allows an instructor 
partial to the objects early approach to emphasize 00 from the start. Chapter 6, Objects: Data Abstraction, 
shows how the progr amm er can benefit in important ways from Java and object-oriented progra mmin g. 
Object-oriented concepts are defined, and the way in which these concepts are supported by Java is intro¬ 
duced. Chapter 7, Inheritance , develops inheritance and dynamic method dispatch, two key elements in the 
OOP paradigm. 
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Terminal input and output. Java has added a Scanner class that makes terminal input easy. This replaces 
our first edition ti o package which is no longer needed. Also the addition of pri ntf () for variable argu¬ 
ment fromatted output is discussed. 

Container Classes and Generics in Java. The text covers this added feature to Java 5.0. Containers are imple¬ 
mented as generics. Standard containers include Vector, LinkedList, Arraylist and PriorityQueue. These also 
allow Iterator access and can be used with the for-iterator statement that hides indexing. 

Swing and Graphical User Interfaces. .An important part of Java is its support for platform independent cre¬ 
ation of graphical user interfaces and the web based programs called applets. InChapter 8 , Graphical User 
Interfaces: Part I and Chapter 9, Graphical User Interfaces: Part II, we present a basic introduction to using 
the standard Java package Swing, for building GUIs. These chapters provide enough information to create 
useful and interesting applets and GUIs. A few additional GUI components are presented briefly in Appendix 
C, Summary of Selected Swing Components. For students anxious to begin writing applets, simple applets are 
introduced in a series of exercises beginning in Chapter 2, Program Fundamentals. These exercises are com¬ 
pletely optional. The coverage of applets and GUIs in Chapter 8, Graphical User Interfaces: Part I and Chapter 
9, Graphical User Interfaces: Part II does not depend upon the student having done or read the earlier applet 
exercises. 

Threads. Multi-threaded progr ammin g is not usually discussed in a beginning text. However, some under- 
standing of threads is essential tor a true understanding of the workings of event driven GUI based pro¬ 
grams. In addition, the authors feel that thread-based progr ammin g will become increasingly important at all 
levels of the programming curriculum. Threading is explained in Chapter 13, Threads: Concurrent Program¬ 
ming, and used to introduce the reader to client/server computing. This book gives a treatment suitable to 
the beginning programmer that has mastered the topics in the preceding chapters. 

Course-Tested. This book is the basis oi courses given by the authors, who have used its contents to train stu¬ 
dents in various forums since 1997. The material is course-tested, and reflects the author’s considerable 
teaching and consulting experience. 

Code examples. All the major pieces of code were tested. A consistent and proper coding style is adopted 
from the beginning and is one chosen by professionals in the Java community. The code is available at the 
Addison Wesley Longman Web site (www.awl.com). 

Common Programming Errors. Many typical programming bugs, along with techniques for avoiding them, are 
described. This books explains how common Java errors are made and what must be done to correct them. 
The new edition also describes the use of assertions that came in with Javal.4. 

Exercises. The exercises test and often advance the student’s knowledge of the language. Many are intended 
to be done interactively while reading the text, encouraging self-paced instruction. 

Web site. The examples both within the book are intended to exhibit good programming style. All examples 
for this book are available on the web at www.soe.ucsc.edu/-pohl/java. 

New in the Second Edition. Java 5.0 came out in September of 2004 with important changes over the original 
language. These include: container based generics, enum types, assertions, more threading refinements, ter¬ 
minal 10 using Scanner, and formatted 10 using printfO. We have included all these important topics and 
where possible revised the text to take advantage of them. 

Course use: 

# First Course in Programming: Java by Dissection is designed to be used as a basic first programming 
course - similar in scope to courses that used C, Pascal, or C++. Chapters 1-6 cover such a curriculum. 

# First Course in Programming - Swing emphasis: By using supplementary material at the end of each of 
the first chapters the instructor can take a GUI approach as opposed to the traditional terminal I/O 
approach. 

# CS1 Course in Programming: By covering material at a more rapid pace for well prepared computer sci¬ 
ence majors the book can function as the primary text in a CS1-2 sequence. The instructor wot id select 
more advanced exercises and cover material through chapter 11. 































XIV 


Preface 



Second Course In Progr ammin g: The book can be used as a second or advanced course covering object- 
oriented progr ammin g. Chapters 2-5 can be skimmed by anyone already fa mili ar with a procedural pro¬ 
gramming language such as C or Pascal. A programmer already familiar with OOP concepts could also 
skim chapters 6 and 7. Chapters 8-13 provide a mix of interesting advanced topics, not generally covered 
in a be ginnin g programming course. 
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to write programs that can use the Web’s resources. These include extensive support for graphical user inter¬ 
faces, 


around the world, and the ability to write programs that run in parallel or on several computers at the same 
time. 


In this chapter we give an overview of how to solve a problem on a computer. In this process, you must first 


the computer can follow. Finally, you must use a programming language, such as Java, to express the steps in 
a form “understandable” by the computer. The Java form of the solution is then translated by a program 
called a compiler into the low-level operations that the computer hardware can follow directly. 

We then discuss why Java is creating such a fuss in 
importance of computing on 
partly behind the switch to Java. 


, we explain the 
, or GUIs, that are 


Throughout this text we feature carefully described examples, many of which are complete programs. We 
often dissect them, allowing you to see in detail how each Java programming construct works. Topics intro¬ 
duced in this chapter are presented again in later chapters, with more detailed explanations. The code and 
examples are meant to convey the flavor of how to program. You should not be concerned about understand¬ 
ing the details of the examples. They are given in the spirit of providing an overview. If you are already famil¬ 
iar with what a program is and want to start immediately on the nitty-gritty of Java progr ammin g, you may 
skip or scan this chapter. 



1.1 RECIPES 


Computer programs are detailed lists of instructions for performing a specific task or for solving a particular 
type of problem. Progr amlik e instruction hsts, sometimes called algorithms , for problem solving and task 
performance are commonly found in everyday situations. Examples include detailed instructions for knitting 
a sweater, making a dress, cooking a favorite meal, registering for classes at a university, traveling from one 
destination to another, and using a vending machine. Ex aminin g one of these examples is instructive. 


Consider this recipe for preparing a meat roast 
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The recipe is typically imprecise—what does “sprinkle” mean, where is the thermometer to be inserted, and 
what is a “sufficient amount” of pan drippings? 

However, the recipe can be formulated more precisely as a list of instructions by taking some liberties and 
reading “between the lines.” 

Cooking a roast 

1. Sprinkle roast with 1/8 teaspoon salt and pepper. 

2. Turn oven on to 150° C. 

3. Insert meat thermometer into center of roast. 

4. Wait a few minutes. 

5. If oven does not yet register 150° C, go back to step 4. 

6. Place roast in oven. 

7. Wait a few minutes. 

8. Check meat thermometer. If temperature is less than 80° C, go back to step 7. 

9. Remove roast from oven. 

10. If there is at least 1/2 cup of pan drippings, go to step 12. 

11. Prepare gravy from meat stock and go to step 13. 

12. Prepare gravy from pan drippings. 

13. Serve roast with gravy. 

These steps comprise three categories of instructions and activities—those that involve manipulating or 
changing the ingredients or equipment, those that just examine or test the “state” of the system, and those 
that transfer to the next step. Steps 1 and 6 are examples of the first category; the temperature test in step 8 
and the pan dripping test in step 10 are instances of the second category; and the transfers in steps 5 and 8 
(“go to step x”) are examples of the last category. 

By using suitable graphical symbols for each of these categories, a simple two-dimensional representation of 
our cooking algori thm can be obtained, as shown in the following illustration. 
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Such a figure is called a flowchart. To perform the program (prepare the roast), just follow the arrows and the 
Instructions in each box. The manipulation activities are contained in rectangles, the tests are shown in dia¬ 
monds, and the transfer or flow of control is determined by the arrows. Because of their visual appeal and 
clarity, flowcharts are often used instead of lists of instructions for informally describing programs. Some 
cookbook authors even employ flowcharts extensively. In this book we use flowcharts in Chapter 3, State- 
merits and Control Flow , when describing the behavior of some Java language constructs. 



1.2 ALGORITHMS—BEING PRECISE 


Our recipe for preparing a roast can’t be executed by a computer because the Individual Instructions are too 
loosely specified. Let’s consider another example—one that manipulates numbers instead of food. You need 
to pay for some purchase with a dollar bill and get change in dimes and pennies. The problem is to determine 
the correct change with the fewest pennies. Most people do this simple everyday transaction unthinkingly. 
But how do we precisely describe this algorithm? 

In solving such a problem, trying a specific case can be useful. Let’s say that you need to pay 77 cents and 
need change for a dollar. You can easily see that one dollar minus the 77 cents leaves you with 23 cents in 
change. The correct change having the fewest coins in dimes and pennies would be two dimes and three pen¬ 
nies. The number of dimes is the integer result of dividing 23 by 10 and discarding any fraction or remain¬ 
der. The number of pennies is the remainder of dividing the 23 cents by 10. An algorithm for performing this 
change for a dollar is given by the following steps. 

Change-making algorithm 

1. Assume that the price is written in a box labeled p ri ce. 

2. Subtract the value of pri ce from 100 and place it in a box labeled change. 

3. Divide the value in change by 10, discard the remainder, and place the result in a box labeled 
di mes. 

4. Take the integer remainder of change divided by 10 and place it in a box labeled penni es. 

5. Print out the values in the boxes di mes and penni es with appropriate labels. 

6. Halt. 
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This algorithm has four boxes, namely, price, change, dimes, and pennies. Let’s execute this algorithm 
with the values given. Suppose that the price is 77 cents. Always start with the first instruction. T he contents 
of the four boxes at various stages of execution are shown in the following table. 


Box 

Step 1 

Step 2 

Step 3 

: 

Step 4 


Step 5 

' 

PRICE 

77 

77 

77 

77 

// 

CHANCE 


23 

23 

23 

23 

DIMES 



2 

2 

2 

PENNIES 




3 

3 


To execute step 1, place the first number, 77, in the box pri ce. At the end of instruction 2, the result of sub¬ 
tracting 77 from 100 is 23, which is placed in the box change. Each step of the algorithm performs a small 
part of the computation. By step 5, the correct values are all in their respective boxes and are printed out. 
Study the example until you’re convinced that this algorithm will work correctly for any price under S1.00. A 
good way to do so is to act the part of a computer following the recipe. Following a set of instructions in this 
way, formulated as a computer program, is called hand simulation or bench testing. It is a good way to find 
errors in an algorithm or program. In computer parlance these errors are called bugs , and finding and remov¬ 
ing them is called debugging . 

We executed the change-making algori thm by acting as an agent, mechanically following a list of instructions. 
The execution of a set of instructions by an agent is called a computation. Usually the agent is a computer; in 
that case, the set of instructions is a computer program. In the remainder of this book, unless explicitly 
stated otherwise, we use program to mean computer program. 

The algorithm for making change has several important features that are characteristic of all algorithms. 

Characteristics of Algorithms 

# The sequence of instructions will terminate. 

% The instructions are precise. Each instruction is unambiguous and subject to only one interpre¬ 
tation. 

# The instructions are simple to perform. Each instruction is within the capabilities of the execut¬ 
ing agent and can be carried out exactly in a finite amount of time; such instructions are called 
effective. 

% There are inputs and outputs. An algorithm has one or more outputs (“answers”) that depend on 
the particular input data. The input to the change-making algorithm is the price of the item pur¬ 
chased. The output is the number of dimes and pennies. 

Our description of the change-making algorithm, although relatively precise, is not written in any formal pro¬ 
gramming language. Such informal notations for algorithms are called pseudocode , whereas real code is 
something suitable for a computer. Where appropriate we use pseudocode to describe algorithms. Doing so 
allows us to explain an algorithm or computation to you without all the necessary detail needed by a com¬ 
puter. 

The term algorithm has a long, involved history, originally stemming from the name of a well-known Arabic 
mathematician of the ninth century, Abu Jafar Muhammed Musa Al-Khwarizmi. It later became associated 
with arithmetic processes and then, more particularly, with Euchd’s algorithm for computing the greatest 
common divisor of two integers. Since the development of computers, the word has taken on a more precise 
me anin g that defines a real or abstract computer as the ultimate executing agent—any terminating computa¬ 
tion by a computer is an algorithm, and any algorithm can be programmed for a computer. 
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MPLEMENTING OUR ALGORITHM IN JAVA 


In this section we implement our change-making algorithm in the Java progr ammin g language. You need not 
worry about following the Java details at this point; we cover all of them fully in the next two chapters. We 
specifically revisit this example in Section 2.10.1, An Integer Arithmetic Example: Change , on page 31. For 
now, simply note the similarity between the following Java program and the informal algorithm presented 
earlier. You not only have to be able to formulate a recipe and make it algorit hmi c, but you finally have to 
express it in a computer language. 

// MakeChange.java - change in dimes and pennies 
import java,util// use Scanner for input 

class MakeChange { 

public static void main (String[] args) { 
int price, change, dimes, pennies; 

Scanner scan = new Scanner(System.in); 

System.out.println("type price (0 to 100):"); 
price = scan.nextlntO ; 

change = 100 - price; //how much change 

dimes = change / 10; //number of dimes 

pennies = change % 10; //number of pennies 

System.out.print("The change is :"); 

System.out.print(dimes); 

System.out.print(" dimes "); 

System.out.print(pennies); 

System.out.print(" pennies.\n M ); 

} 

} 




Dissection of the MakeChange Program 


# java.uti1.*; // use Scanner for input 

A package is a library or collection of previously written program parts that you can use. This line tells 
the Java compiler that the program MakeChange uses information from the package j ava. uti 1. It 
allows you to use the Scanner class, which we explain shortly. 

# int price, change, dimes, pennies; 

This program declares four integer variables. These hold the values to be manipulated. 

# Scanner scan = new Scanner(System.in); 

This declares a Scanner variable scan that is tied to System . i n. This lets scan provide input by typing 
to the terminal. 

# System.out.println( M type price(0 to 100):"); 

This line is used to prompt you to type the price. Whenever a program is expecting a user to do some¬ 
thing, it should print out a prompt telling the user what to do. The part in quotes appears on the user’s 
screen when the program is run. 
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# price = scan.nextlntO ; 

The scan. nextlntO is used to obtain the input from the keyboard. The value read is stored in the vari¬ 
able pri ce. The symbol = is called the assignment operator. Read the first line as “pri ce is assigned the 
value obtained from the typing an integer on your keyboard. At this point you must type in an integer 
price. For example, you would type 77 and then hit Enter. 

# change = 100 - price; //how much change 

This line computes the amount of change. 

dimes = change / 10; //number of dimes 

# pennies = change % 10; //number of pennies 

The number of dimes is the integer or whole part of the result of dividing change by 10. The symbol /, 
when used with two integers, computes the whole (nonfraction) part of the division. The number of pen¬ 
nies is the integer r emain der of change divided by 10. The symbol % is the integer remainder or modulo 
operator in Java. So if change is 23, the integer divide of 23/10 is 2 and the integer remainder or modulo 
of 23 % 10 is 3. 

# System.out.print("The change is : "); 

System.out.print(dimes); 

System.out.print(" dimes ”); 

System.out.print(pennies); 

System.out.print(" pennies.\n"); 

In this example the System.out. pri nt() statements cause the values between the parentheses to be 
printed on the computer console. The first one just prints out the characters between the quotation 
marks. The second one converts the value in di mes to the sequence of digits and prints those digits. The 
other print statements are similar. For an input value of 77, the output would be 



The \n in the last print statement indicates tiiat a newline should be sent to the console, ending the line 
of output. 




1.4 WHY JAVA? 


A variety of progr ammin g languages are available for expressing programs, but the most useful ones are 
suitable for both machine and human consumption. In this book we cover programming by using one such 
language—the programming language Java. 

Java is a relatively new programming language, first introduced in 1995. In this book a language is needed 
that allows algorithms to be easily understood, designed, analyzed, and implemented as computer programs. 
The following is an excerpt from the original paper introducing Java to the world. 
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In his science-fiction novel The Rolling Stones , Robert A. Heinlein comments: 

Every technology goes through three stages: first a crudely simple and quite unsatisfactory 
gadget; second, an enormously complicated group of gadgets designed to overcome the short¬ 
comings of the original and achieving thereby somewhat satisfactory performance through 
extremely complex compromise; third, a final proper design therefrom. 


Heinlein’s comment could well describe the evolution of many progr ammin g languages. Java presents a new 
viewpoint in the evolution of programming languages—creation of a small and simple language that’s still 
sufficiently comprehensive to address a wide variety of software application development. Although Java is 
superficially similar to C and C++, Java gained its simplicity from the systematic removal of features from its 
predecessors. 

We agree with its creators that Java has, to a large extent, lived up to the promise of a small, simple, yet com¬ 
prehensive programming language. As such, Java is both an excellent progr ammin g language for real pro¬ 
gram development and a good first programming language. 

Possibly even more important for Java’s initial success are the features that make it appropriate for develop¬ 
ment of programs distributed over the Internet. These programs, called applets , execute inside Internet 
browsers such as Firefox, Mozilla, Netscape, and Internet Explorer. 



1.5 NETWORK COMPUTING AND THE WEB 


Much of modern computing is done in a connected environment. That is, computers are connected to other 
computers in a network. This connection allows the computers to exchange information or to “talk to each 
other.” Java was developed with network computing as the normal environment. It has many features and 
libraries of parts of programs that promote networking. Earlier languages and systems viewed a computer as 
a lone instrument doing si gnif icant computations, the results of which would largely be output to a screen or 
printer. By promoting networking whereby computers are connected and pass results to each other dynami¬ 
cally— and cooperate on large-scale computations—Java became the principal language for computing on 
networks. 

The largest network is the global network called the Internet Using the Internet, researchers at the European 
Particle Physics Laboratory (CERN) developed a way to share information via a formatting language called 
hyper-text markup-language , or HTML. The computers exchanged HTML documents by means of a protocol 
called hyper-text transfer protocol , or HTTP . A protocol is like a language that computers use to “talk” to each 
other. HTML allows one electronic document to link to another electronic document on a different computer. 
The program used to view HTML documents and follow the links is called a browser. With the chck of a but¬ 
ton, a user could move from one document on one computer to another, related document, on another com¬ 
puter. Because of these links, the resulting web of documents was dubbed the World Wide Web or simply the 
Web. Today, many people equate the Web with the Internet, but the Web is only one application of the tech¬ 
nology known as the Internet. 

Java programs, called applets , can be written to automatically load and execute by following a link in the 
Web. This ability to embed Java programs in HTML documents was a primary factor in the early success of 
Java. With Java applets, Web documents are no longer static text, images, or video segments. Web documents 
can provide all the interaction of any program. We discuss graphical user interfaces and applets in Chapter 8, 
Graphical User Interfaces: Part I. 

If you’re interested in an early exposure to applets, we also provide templates for simple applets in the exer¬ 
cises at the end of Chapters 2 through 6. 
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From the World Wide Web (www) and HTTP, you can begin to make some sense of the ubiquitous Internet 
addresses such as http://www.company.com. This type of address is called a universal resource locator , or 
URL These are addresses embedded in HTML documents, linking one document to another. 

Client-server computing is an essential new element in computers that manage communications and compu¬ 
tations. The server, typically a fast computer with a very large amount of bard disk storage, gives out infor¬ 
mation to cbents upon request. An example would be a server giving out stock market quotes to cbents that 
request it. The network support in Java makes implementing client-server programming solutions easy. In 
Chapter 9, Graphical User Interfaces: Part //, we show you bow to implement a simple Java server program 
that can connect and respond to requests from multiple cbents on other computers. 
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1.6 HUMAN-COMPUTER INTERACTION AND THE GUI 


In the early days of computing, most interaction between a computer and a human being was in the form of 
typed input to the computer and printed output to the person. Most human-computer interaction today is 
done with a graphical user interface (GUI— pronounced gooey). The user has a keyboard, usually similar to a 
standard typewriter keyboard, a pointing device, usually a mouse, and a display device capable oi displaying 
both text and graphics. 


The user’s display is usually divided into viewing areas called windows. Associated with the windows are 
menus of commands relating to manipulation of the data displayed in the window. The display (screen) may 
also contain icons, or small graphical images, whose visual appearance is designed to signify their functions. 
For example, a picture of a trash can represents deleting a file, and an arrowhead is used to scroll a viewing 
screen. The following screen shot of a typical desktop shows several windows, icons, and a row of menus 
across the top of each window. 
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// MakeChan&e. java - ch 
Import tio.*; // use th 

cXas s Make C hange { 

pubXic static void ma 
int price, change. 
System.out.printin( 
price = Console.in.: 
change = 100 - pric» 
dimes = change / 10 
pennies = change % 
System, out. pr int ( r, T! 
System, out. print (dii 
System.out.print (” 
System, out. pr int (pe: 
System.out.print( M ; 


Object 

main(String[j) 


I 


For many years, the task of creating a graphical user interface for a new application was extremely time-con¬ 
suming and difficult. The programming languages and operating systems in use did not make building such 
interfaces easy. These interfaces were usually built from libraries of program parts that were suitable only 
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1,6 Human-Computer interaction and the GUI 

for one particular operating system. If a company building a new program wanted to have its program run on 
computers with different operating systems, it would have to create multiple versions of the programs. 

Java provides a solution. Software companies now sell programs that make building graphical user interfaces 
relatively easy. Java includes a library of program parts called Swing for building graphical user interfaces. 
The program parts in Swing can be used on any computer that can run Java programs. Thus a programmer 
can now write one version of a program and have it run on many different kinds of computers. Although in- 
depth coverage of Swing is beyond the scope of this book, Swing is simple enough to use that even beginning 
programmers can begin to build programs with graphical user interfaces. We discuss Swing further in Chap 
ter 8, Graphical User Interfaces: Part I and Chapter 9, Graphical User Interfaces: Part II. 

By the end of this book, you will be writing your own sophisticated applets and regular Java programs with 
GUIs. If you’ve used a Java-enabled browser, such as Netscape or Explorer, you’ve probably unknowingly 
made use of an applet. If not, you can try out a simple applet calculator right now by going to 
www.soe.ucsc.edu/-charlie/java/jbd/MiniCalcApplet.html. This is the same applet presented in Section 8.8, 
Applets , on page 248. 



Summary 


# Informally, an algorithm is a list of instructions for performing a specific task or for solving a particular 
type of problem. Algorithmlike specifications for problem solving and task performance are commonly 
found in everyday situations. A recipe is a kind of algorithm. 

<§ One graphical representation of an algorithm is a flow chart. To perform the algorithm, the user just fol¬ 
lows the arrows and the instructions in each box. The manipulation activities are contained in rectangles, 
the tests are shown in diamonds, and the transfer or flow of control is determined by the arrows. 
Because of their visual appeal and clarity 7 , flow charts are often used instead of hsts of instructions for 
informally describing algori thm s. 

# Algorithms that can be executed on computers are called programs. Programs are written in special lan¬ 
guages called programming languages, such as Java, which we use in this book. 

# Modem computing is done in a connected environment. A computer is connected to other computers in 
a network. This connection allows the computers to exchange information or to “talk to each other.” Java 
was developed with network computing as the normal environment. The largest network is the global 
network called the Internet. This network is used to exchange documents throughout the world with a 
common format called HTML. This format allows links to be followed across the Internet. Because of 
these links, the resulting web of documents was named the World Wide Web or simply the Web. 

# It is possible to write Java programs called applets, that are automatically loaded and executed as the 
result of following a link in the Web. This ability to embed Java programs in HTML documents is a pri¬ 
mary factor in the success of Java. With Java applets, Web documents are no longer static text, images, or 
video segments. Web documents can provide all the interactions of any program. 



Review Questions 


1. What is an algorithm? 

2. A graphical description of a computation using boxes and arrows is called a 

3. Informal, but relatively precise descriptions of algorithms are called_ 
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4. What is bench testing? Why is it important? 

5. What did java, uti 1 refer to in the MakeChange .java program? 

6. What was System. out. pri nt () used for in the Java program? 

7. What is HTML? What is HTTP? What is URL? 

8. What is a browser? Name a commonly used browser. 

9. What are the primary components of a typical human-computer interface today? 

10. The information provided by the user to a program when it executes is called the-. The 

answers provided by the program are called the_. 

11. What is Swing? 



Exercises 


1. Write a flow chart for the following recipe for cooking baked beans (taken from The Natural Foods Cook¬ 
book, Nitty Gritty Productions, Concord, California, 1972). 


Bring apple juice and water to a boil and add beans so slowly that boiling doesn’t stop. Reduce 
heat after beans are in water and s imm er 2 to 2 and a half hours or until beans are almost ten¬ 
der. Drain beans, reserving liquid, and add other ingredients to beans. Place in oiled baking 
dish and bake covered 2 to 3 hours in 2508 oven. Uncover for the last hour of cooking. If beans 
become dry, add a little of the reserved bean water. About 15 minutes before removing from 
the oven, add the fresh diced tomato. 


2. Let m and n be positive integers. Draw a flowchart for the following algorithm for computing the quo¬ 
tient q and remainder r of dividing m by n. 

1. Set q to 0. 

2. If m < n, then stop, q is the quotient and m is the remainder. 

3. Replace m by m - n. 

4. Increment q by 1. 

5. Go to step 2. 

3. Bench test the algorithm in the previous exercise. Use m = 4 and n = 2 as values. 

4. Let a rectangle that is aligned with the coordinate axes be represented by the coordinates of its lower left 
and upper right comers, ( xmin , ymin) and (xmax, ymax), respectively, as shown in the following illustra¬ 
tion. Given two such rectangles, R1 and R2 , devise an algorithm that finds the rectangle, if any, that is 
common to both R1 and R2. The input data are the eight real numbers representing the coordinates of 
the rectangles’ corners. The illustration shows two rectangles that have a common rectangle, shown in 
grey. 
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(xmax, ymax) 


(xmin, ymin) 


x axis 


Possible R2 



Possible R1 


5. Suppose that a line segment is represented by its two endpoints, PE = ( xe , ye) and PP = (xp, yp). For two 
line segments LI and L2, devise an algorithm that computes the coordinates of their point of intersec¬ 
tion, if any. (Two line segments intersect if they have only one point in common.) 

6. Make a hst of all the automatic interactions that you have with computers—for example, utility bills, 
automatic mailing lists, class scheduling, and so on. 

7. Give a detailed step-by-step procedure, also called an algorithm, for 

# traveling from your place of residence to school or work, 

• manually dividing one number by another (long division), 

• taking an unordered set of numbers and putting them in ascending sequence (i.e., “sorting” the 
numbers in ascending sequence), or 

# playing, and never losing, the game of Tic-Tac-Toe. 



























12 


introduction 


$ 

















'A'.'rSSV-- 


iVHjrtVr 






mw, 

■.v.vav, 


; : : . .-' 


jSsjfiiiwSft 


\\ 

wwm 


wm 








'■frAW&ti 

m$w 

»yi.v.vi 




' ■. 






«i|3 


■ 


" "■ ■=! 


wm 


m 


kyy$y. 


wmm 


■■m 


wm 

m:;y. 




Program Fundamentals 






it 


-V.-VA' 


■WK 


mmrnw 




mmm 


yy.y 

•-■■■It- 


«& 33 B 


WkWM 


': • :■: 

\a\, 

r-yy.-. y. ’. ,->i- 
: : : : ; : ->■ 




1 


.vv,-. 




M 


■ite 

g§ 

Wm 




mm 

.V.V 




v/wy.wvw. 

■■■■■■■■ %V.VAV.W.V. 
, ■ ,*. • f V. W- , . , rV-V, , -W. 




|&>- 






^-jisy-vyxyr-y 






:;isa 






.'.W. 




S3 




. 

V‘ y'-'x* :•;*>'■.■/,' 













In this chapter we introduce programm i ng fundamentals in Java. We write a Java program by using different 
elements of the Java language. The most basic elements are the tokens of the language. Tokens are the words 
that make up the sentences of the program. Progr ammin g is comparable to writing. To write an essay we 
write words that make up sentences, sentences that make up paragraphs, and paragraphs that make up 
essays. In this chapter we concentrate on how to use the “words” and combine them into the program equiv¬ 
alent of useful sentences and paragraphs. 







2.1 “HELLO, WORLD!” IN JAVA 


A simple first Java program is the classic “Hello, 
Hello, world! on the computer’s screen. 


world!” program, so named because it prints the message 



s*. 


rt 




HelloWorld.java 
Purpose: 

The classic "Hello, 
It prints a message 


world!" program, 
to the screen. 








* Author: Jane Programmer 

* as derived from Kernighan and Richie 

V 

class HelloWorld { 

public static void main (String[] args) { 
System.out.println( M Hel1o, world!"); 

} 





} 
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Program Fundamentals 




Dissection of the HelloWorld Program 



He!1 eWorld.java 
Purpose: 



Everything between a /* and a */ is a comment. Comments are ignored by the Java compiler and are 
inserted to make the program more understandable to the human reader. Every program should begin 
with a comment such as the one in this example. In our examples, the name of the file appears in the 
comment. This example indicates that it is from the file HelloWorld.java. Other things to include in pro¬ 
gram comments are the function or purpose of the program, the author of the program, and a revision 
history with dates, indicating major modifications to the program. 


• class HelloWorld { 


The word cl ass is a keyword preceding the name of the class. A keyword has a predefined special pur¬ 
pose. A class is a named collection of data and instructions. The name of the class being defined In this 
example is Hel 1 oWor 1 d . The left brace T begins the definition of a class. A matching right brace T is 
needed to end the class definition. Forgetting to match braces is a common error. 


* public static void main (String[] args) { 


This line declares that the class Hel loWorl d contains a method with the name mai n. A method is a 
named group of instructions within a class. In this example, only one method, named mai n, is defined 
for the class Hel 1 eWorld. In Chapter 4, Methods: Functional Abstraction , we create classes that contain 
several methods in a single class. When we use the name of a method, we add parentheses at the end to 
remind you that it is a method. This convention comes from actual Java code, wherein the name of a 
method is always followed by parentheses. The method defined by this line is thus referred to as 

main(). 

There are two kinds of Java programs: stand-alone applications and applets. The method main() 
appears In every stand-alone Java program indicating where program execution will begin. Later we use a 
different line that serves a similar purpose for applets. An explanation of the words publ i c, stati c, 
and void in this line is left until later. 


• { 

System.out.println("Hello, world!"); 

> 

The entire body of the method mai n(), the real instructions to the computer, appears between the 
braces. In this example, just one instruction prints the desired message. You can memorize this instruc¬ 
tion and use it as an incantation to get something printed out on your computer screen. What gets 
printed is between the quotation marks. 




2.2 COMPILING AND RUNNING YOUR JAVA PROGRAM 


You will be dealing with two different representations of your programs: the part you write and a form more 
suitable for the computer to use when it finally runs your program. The text you write to give the computer 
instructions is called the source code or simply the source. This source code will be compiled by the Java com¬ 
piler into a form more suitable as instructions to the computer called object code. The source code form of 
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2.2 Compiling and Running Your java Program 

the program is represented in the language Java that you will be learning. Informally, you can think of the 
source code as the raw form of the program in contrast to the ob ject code, which is the cooked or compiled 
form. In Java, all source code file names have the suffix Java , such as HelloWorldJava. The result of correctly 
compiling HelloWorldJava is the object code HelloWorld.class. In some situations, the name of the file with¬ 
out the Java and the name of the class defined in the file must be the same. Although this requirement does 
not apply to the programs in the first part of this book, we follow that practice even when it isn’t required 
and suggest that you do the same. 

There are many names and forms for the machine representation of a program after it has been processed 
somewhat by the computer. A common first step in processing source code is to compile it, which means to 
translate it into a form more suitable for the computer. For most co mm on progr ammin g languages, this com¬ 
piled form is called the machine code , object code , or binary form. When you buy a piece of software you usu¬ 
ally get binaries or an executable image . For Java, this form is a bit different and is called Java Bytecode. 
These bytecodes are the same whether you are r unnin g on a Macintosh, on an Intel machine with Microsoft 
Windows, or on a machine from Sun running Unix. This sameness is an important advantage of Java pro¬ 
grams, as they can be written to be platform independent, which is generally not true for most other pro¬ 
gramming languages, such as C or COBOL. 

In Java, all bytecode files must have a name that ends in .class such as HelloWorld.class. The word class is 
used because, in Java, programs are broken into chunks called classes, much like a chapter is broken into 
sections. The following diagram illustrates the compilation process and the conventions just described. 


The Compilation Process 


HelloWorldJava 

(source) 


Java Compiler 


HelloWorld.class 

(bytecode) 


There are two principal methods for compiling and running Java programs. One method uses an Integrated 
Development Environment (IDE), of which there are many for Java. The actual details of compiling for each of 
the IDEs vary slightly but the basic steps are the same. 

JAVA VIA THE IDE 

L. Use the editor that comes with the IDE to create the source file. These editors generally help with 
syntax by using special fonts or colors for keywords and helping you match braces, and so on 

2. Create a project and add your source file to the project. 

3. Select Run from a menu. The IDE will automatically determine that the source file needs to be 
compiled and compile it before trying to run the program. 

The other principal method is the command line approach In it you run the compiler yourself from the com¬ 
mand line of either a Command Prompt in Windows or Unix terminal or shell program. For both Unix and 
Windows the steps are the same. 

Java via the Command Line 

1. Use your favorite text editor to create the source file. Save the source into a file ending with the 
extension .java. 

2. Compile the program with the command j avac followed by the source file name—for example, 
javac Hel 1 oWorld. java. 

3. If the program compiles without errors, run the program with the command j ava followed by 
the name of the class. Do not append .class, as in HelloWorld.class; use only the class name— for 
example, java HelloWorld. 

The last two steps are shown as follows for the program Hel 1 oWorl d. 
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os~prompt>javac HelloWorld.java 
os-prompt>java HelloWorld 
Hello, world! 
os-prompt> 



2.3 LEXICAL ELEMENTS 


Java has rules about how its language elements can be put together to form a complete program. In this sec¬ 
tion we begin by looking at the various words and symbols, called lexical elements, that are used to construct 

Java programs. 

The most fundamental element in the structure of a program is a single character that can be displayed on a 
computer screen or typed at a computer keyboard. Prior to Java, most progra mmin g languages, such as C 
and C++, used the ASCII character set. It provides for 127 different characters, which is enough to represent 
all the characters on the conventional English language keyboard. This set may seem like a lot, but when you 
consider all the human languages In the world and the various symbols they use, it is inadequate. Because 
Java was designed to be used throughout the world, not just in English-speaking countries, Java developers 
adopted the Unicode character set. It provides for more than 64,000 different characters. 

When a Java compiler first begins to analyze a Java program, it groups the individual characters into larger 
lexical elements, usually called tokens. Some tokens—such as the plus sign, +, which is the Java symbol used 
to add two numbers—are only one character long. Other tokens—such as the keywords class and publ i c 
are many characters long. These basic tokens are then combined into larger language i orrns, such as expres¬ 
sions. An example of an expression comprising three tokens is x+y. 

There are five types of tokens: keywords, identifiers, literals, operators, and punctuation. White space and 
comments are two additional lexical elements that are discarded early in the compilation process. 


23.1 WHITE SPACE 

White space in Java refers to the space character, which you get when you strike the space bar on the key¬ 
board; the tab character, which is actually one character, although it may appear as several spaces on your 
screen; and the newline character which you get when you hit the Return or Enter key on the keyboard. White 
space is used primarily to make the program look nice and also serves to separate adjacent tokens that are 
not separated by any other punctuation and would otherwise be considered a single, longer token. For exam¬ 
ple, white space is used to separate the following three tokens: 

public static void 

in the He 1 loWorld program. In such situations, where one white space character is required, any number of 
white space characters can be used. For example, we could have put each of the words public, static, and 
void on separate lines or put lots of spaces between them as in 

public static void main(... 

Except for string literals, which we discuss shortly, any number of adjacent white space characters even 
mixin g tab, space, and newline characters—is the same as just one white space character as far as the struc¬ 
ture and meaning of the program are concerned. Stated another way, if you can legally put in one space, you 
can put in as many spaces, tabs, and newlines as you want. You can’t put white space in the middle of a key¬ 
word or identifier, such as a variable or class name. We discuss keywords, identifiers, and variables later in 

thi s chapter. 











































23.2 COMMENTS 


23.2 Comments 17 


Comments are very Important In writing good code and are too often neglected. The purpose of a comment is 
to provide additional Information to the person reading a program. It serves as a concise form of program 
documentation. As far as the computer is concerned, the comment does not result In a token; it separates 
other tokens or is ignored completely when it isn’t needed to separate tokens. Java has three ways to specify 
comments. 


A single line comment begins with // and causes the rest of the line—all characters to the next newline—to 
be treated as a comment and ignored by the compiler. It is called a single line comment because the comment 
can’t be longer than a single line. By definition, the comment ends at the end of the line containing the //. 

A multiline comment can extend across several lines in a program. The beginning of the comment is marked 
with /* and the end of the comment is marked with */• Everything between the marks and the marks them¬ 
selves is a comment and is ignored. Here is the multiline comment from our first Java program. 

/* He'lloWorld.java 

* Purpose: 

* This is the classic "Hello, world!" program. 

* It simply prints a message to the screen. 

* Author: 

* Jane Programmer 

* as derived from Kernighan and Richie 

V 


The single asterisks on the intermediate lines are not required and are used merely to accent the extent of 
the comment. These co mm ents are also called block comments. 


The third style of co mm ent is a minor variation on the multiline comment. The beginning marker has an 
additional asterisk; that is, the beginning of the comment is marked with /** and the end of the comment is 
marked with */■ These comments are identical to the multiline comment except that they are recognized by a 


special program called javadoc that automatically extracts such comments and produces documentation for 
the program organized as an HTML document. See Section 4.13, Programming Style , on page 111, for more 
about javadoc. 


2.33 KEYWORDS 

Keywords , also known as reserved words , have a predefined special purpose and can’t be used for any but 
that purpose. Each of the 47 keywords in Java has a special meaning to the Java compiler. A keyword must be 
separated from other keywords or identifiers by white space, a co mm ent, or some other punctuation symbol. 
The following table shows all the Java keywords. 


abstract 

continue 

for 

new 

synchronized 

assert 

default 

goto 

package 

this 

boolean 

do 

if 

private 

throw 

break 

double 

implements 

protected 

throws 

byte 

else 

import 

public 

transient 

case 

enum 

instanceof 

return 

try 

catch 

extends 

i nt 

short 

void 

char 

f i nal 

interface 

static 

volatile 

class 

fi nal ly 

long 

super 

whi 1 e 

const 

float 

native 

switch 
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The keywords const and goto have no meaning in Java. They are keywords in C++, a language that was a 
precursor to Java. They are included as keywords to facilitate error reporting when progra mm ers with C++ 
experience accidentally use them. In addition, the words null, true , and false look like keywords in that 
they have a predefined meaning, but they are in fact literals, as discussed later. 


2.3.4 IDENTIFIERS 

Identifiers are the names used to specify different elements of a Java program, such as a class, method, or 
variable. (We discuss variables in Section 2.4.1, Variables , on page 20.) .An identifier in our first program was 
Hell o Wo rid, a name we picked for the class. Another identifier was the library method name pr intin, a 
name picked by the Java developers. In both cases, the name gives a clue as to the use of that element of the 
program. An identifier is any sequence of Java letters and digits, the first of which must be a Java letter, with 
two exceptions. A keyword can’t be an identifier, and the special literal terms true, fal se, and nul 1 can’t be 
used as identifiers. The Java letters and digits include the letter and digit symbols f or many modern written 
languages. The Java letters include the English language uppercase and lowercase letters, the S, and the _ 
(underscore). The last two are included because of Java’s close kinship to the programming language C, 
which included these symbols as legal characters in identifiers. The Java digits are 0 through 9. In our exam¬ 
ples, we use only En glish letters and digits. The following are some examples of legal identifiers along with 
comments providing some explanation. 

data //variable name conveying its use 

HelloWorld //class name 

youCanAlmostMakeASentence //uniikely 

nextlnt //method name from Scanner class 

x //simple variable usually double 

_123 //obscure name-a poor choice 


The following are some illegal identifiers, along with co 
really is. 


mu 


ents indicating what the sequence of symbols 


3 

x+y 

some**"name 
no Space 
lfloor 
class 


//a digit or integer literal 

//an expression where x and y are identifiers 

//i11egal internal characters 

//intended was noSpace 

//cannot start with a digit 

//keyword - cannot be used as an identifier 


2.3.5 LITERALS 

Java has built-in types for numbers, characters, and booleans. Java also has a standard class type for strings. 
The type of a data value tells the computer how to interpret the data. These built-in types are called primitive 
types in Java. Literals, also called constants, are the literal program representations of values for the primitive 
numeric types, the primitive type boolean, the primitive character type char, and the standard class string 
type Stri ng. Without going into the details of these various types, the following are some examples of literal 
values 



Java Type 

saiii 

wmmm 
• hH 

Explanation 

HI-.,.. '■£ ' 'lliiii 

• 

Examples 

. 

int 

Integers—-numbers without fractional parts 

123 -999 0 

double 

Double precision numbers with fractional parts 

1.23 -0.01 

String 

Arbitrary strings of characters 

"Oh 3” "123” 

boolean 

Logical values true or false 

true false 

char 

Single characters 

'a' '1' 
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Like keywords, the symbols true and fal se can’t be used as identifiers. They are reserved to represent the 
two possible boolean values. We explain later, in more detail, wbat constitutes an acceptable literal for each 
data type. 


23.6 OPERATORS AND PUNCTUATION 

In addition to keywords, identifiers, and hterals, a Java program contains operators and separators or punc¬ 
tuation. The operators are things like “+”, and the separators are things like the that terminates some 
statements and the braces “{ }” used to group things. To fully understand operators, you need to understand 
type, precedence, and associativity. Type determines the kind of value computed, such as i nt or doubl e. 
Precedence determines among operators, such as + and / used in an expression, which is done first. Associa¬ 
tivity is the order in which operators of the same precedence are evaluated and is usually left-most first—for 
example, 

int n = 2; 

n = n * 3 + 2; //an assignment expression 

The variable n is an integer variable initialized to 2. Next n is multiplied by the integer literal 3. This result is 
added to 2, and finally this value is assigned to n, replacing the original value of 2 with the new value of 8. 
Precedence of the multiplication operator * is higher than +, so the multiplication is done before the addi¬ 
tion. Precedence of the assignment operator = is lowest, so assignment occurs as the last action in this 
expression. We discuss precedence and associativity of operators further in Section 2.13, Precedence and 
Associativity of Operators, on page 37. 



2.4 DATA TYPES AND VARIABLE DECLARATIONS 


In order to do something useful, computer programs must store and manipulate data. Many programming 
languages, including Java, require that each data item have a declared type. That is, you must specify the 
kind of information represented by the data, or the data’s type. The data’s type determines how data is repre¬ 
sented In the computer’s memory and what operations can be performed on the data. 

Different programming languages support different data types. A data type can be something as fundamen¬ 
tal as a type for representing integers or as complex as a type for representing a digital movie. Some exam¬ 
ples of data types found in Java are 

# i nt—for representing Integers or whole numbers; 

# doubl e—for representing numbers having a fraction; 

# St ri ng—for representing text; 

# Button—for representing a push button in a graphical user interface; and 

# Poi nt—for representing points in a plane. 


The types of data that are created, stored, and manipulated by Java programs can be separated into two main 
groups: primitive types and class types, or simply classes. 

# There are eight primitive types: 

# the numeric types byte, short, i nt, 1 ong, f 1 oat, and double for storing numeric values; 

# the character type char for storing a single alphabetic character, digit, or symbol; and 

# the type boolean for storing true or fal se. 

Primitive data values can be created by using hterals such as 100, -10.456, ' a*, and true. Primitive values 
can also be operated on by using built-in operators such as + for addition and - for subtraction of two 
numeric values, producing a new primitive value. For example, 


2 + 3 
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uses + (addition) to operate on the two numeric literal values, 2 and 3, to produce the new primitive value, 5. 

Standard Java has more than 1500 classes. The Stri ng, Button, and Poi nt types mentioned previously are 
standard Java classes. You will learn in Chapter 6, Objects: Data Abstraction , that you can create your own 
classes. Also, in Chapter 5, Arrays And Containers , we discuss arrays, which are a special case of class types. 

The data values that are class types are called objects. You can create object data values by using the special 
operator new followed by the class name and possibly some additional values needed to create the new 
object. For example, 

new Button("Quit n ) 

creates a new object describing a button with the label “Quit.” 

You can create new objects of type Stri ng, as a special case, by using the string literal notation that sur¬ 
rounds the text of the string with double quotation marks. For example, "Hello, wo rid!” creates a new 
string object. 

In most cases, the operations supported for the particular class are given a name and invoked by placing the 
name after the object value, separated by a dot. For example, 

"Hello, world!”.1ength() 

operates on the literal string "He! 1 o, worl d! " and evaluates to 13—the number of characters in this string, 
including any blanks. Operations such as 1 engthQ defined for a particular class are called methods. We dis¬ 
cuss methods in great detail in subsequent chapters. 


2,4,1 VARIABLES 

In all but the most trivial programs, such as Hell oWorl d, you will declare variables that are identifiers used 
to refer to data values that are stored in the computer’s memory. These are called variables because a vari¬ 
able actually refers to a particular place in the computer’s memory, and the value stored in the computer’s 
memory can vary as the program runs. A variable declaration always begins with a type and ends with a semi¬ 
colon. The type is used to identify the kind of data that will be stored in the memory location associated with 
the variable being declared. Some examples of variable declarations are 

int i , j ; 

String sentence; 

boolean hot, cold, lukeWarm; 

Button clickToExit; 

Note that you can declare several variables of the same type by separating the names with a comma. Good 
choice of variable names is important to writing clearly understandable code. Stylistically, choose variable 
names that are meaningful. Also, variable names usually start in lowercase, and if they are multiword, the 
internal words start with an uppercase character, as in cl i ckToExi t. 


2.4,2 VARIABLE INITIALIZATION 

Variables can be given initial values. The preceding set of declarations given initial values for each variable 
becomes 

int i - 2, j - 3; 

String sentence = "I am a camera."; 

boolean hot = true, cold = false, lukeWarm = false; 

Button clickToExit = new Button("Exit"); 

Initializing variables with literals of their respective type is normal. In this example, the i nt variable i is ini¬ 
tially given the value 2. The bool ean variable hot is initially true. The Stri ng variable sentence is initial¬ 
ized with a string literal. 
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With the exception of Stri ng, Java has no literals for creating object values. You initialize the Button vari¬ 
able by creating a Button object, using new as discussed briefly earlier. We discuss object creation in Chapter 
6, Objects: Data Abstraction. 



2.5 AN EXAMPLE: STRING CONCATENATION 


The following example Is a complete program that declares three variables: wordl, word2, and sentence. 

Values are then assigned to the parts of the computer memory referred to by those variables. 

// Hel1oWorld2.java ~ simple variable declarations 

class HelloWorld2 { 

public static void main (String[] args) { 

String wordl; // declare a String variable 

String word2, sentence; // declare two more 

wordl = "Hello, "; 

word2 = "world!"; 

sentence = wordl.concat(word2); 

System.out.println(sentence); 

} 

} 




Dissection of the HelIoWorld2 program 


f§ String wordl; // declare a String variable 
String word2, sentence; // declare two more 

Whenever you introduce a new identifier you must declare it. You declare that an identifier is a variable 
by first writing the name of the kind of value the variable refers to, called the type . The type is Stri ng in 
this example. Insert the name of the new variable after the type. For variables in Java, the computer must 
always know the type of value to be stored in the memory location associated with that variable. As 
shown in the second line, you can declare more than one variable at a time by giving first the type and 
then a comma separated list of new identifiers. 

# wordl = "Hello, "; 
word2 = "world!"; 

The symbol = is called the assignment operator and is used to store values in variables. Read the first 
statement as “word i gets the value Hello, ” or “wordl is assigned the value Hel 1 o, ”. Here it is used 
to assign the Stri ng literals "Hel 1 o , " and "worl d ! " to the newly declared variables wordl and word2, 
respectively. The variable name will always be on the left and the new value to be assigned to the vari¬ 
able will always be on the right. Saying “assign the value "Hel 1 o , "to the variable wo rdl” really means 
to store the Stri ng value "Hel 1 o, "in the computer memory location associated with the variable 
wordl. 

il sentence = wordl.concat(word2); 

This statement contains an expression used to create a third Stri ng value, which is then assigned to the 
variable sentence. This expression uses the method concatO, which is defined for values of type 
Stri ng. Recall that operations on objects are called methods. This particular operation requires a sec¬ 
ond Stri ng value placed between the parentheses. The method name concat is short for concatenation. 
The concatenation of two strings is a new string that contains the symbols from the first string followed 
by the symbols from the second string. Note that the first string, wordl, contains a space at the end. 
Thus, when we concatenate the two strings, we get the new string "Hello, world! ", which is assigned 
to the variable sentence. 
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H System.out.println(sentence); 

The program then prints out the string in the variable sentence, which now is " Hel 1 o, worl d! 



As we showed earher, when a variable is declared, it can be given an initial value. This approach essentially 
combines an assignment with the declaration. Using this notation, you can now write the body of mai n () in 
HelloWor1d2 as 

String wordl = "Hello, 

String word2 = "world!"; 

String sentence = wordl.concat(word2); 

System.out.println(sentence); 

You could even combine two initializations in a single statement, 

String word2 = "world!", sentence = wordl.concat(word2); 

although, as a general rule, multiple complex initializations such as this should be placed on separate lines. 


2.5.1 STRINGS VERSUS IDENTIFIERS VERSUS VARIABLES 

A string is a particular data value that a program can manipulate. A variable is a place in the computer’s 
memory with an associated identifier. The following example uses the identifier hello to refer to a variable 
of type String. The identifier stringVary refers to a second variable of type Stri ng. We first assign 
st ri ngVary the value associated with the Stri ng variable hello. Later we reassign it the string value 
"hello". 

//StringVsId.java - contrast strings and identifiers 
class StringVsId { 

public static void main(String[] args) { 

String hello = "Hello, world!"; 

String stringVary; 
stringVary = hello; 

System.out.println(stringVary); 
stringVary = "hello”; 

System.out.println(stringVary); 

} 

} 

The output of this program is 


Hello, world! 
hello 


The program demonstrates two important points. First it shows the difference between the identifier hello, 
which in fact ref ers to the string "Hello, world! ", and the string "hello", which is referred to at one point 
by the variable stri ngVary. This example also shows that a variable can vary. The variable stri ngVary first 
refers to the value "Hel 1 o, worl d ! " but later refers to the value "hel 1 o”. 
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2.6 USER INPUT 


In the programs presented so far, we have generated output only by using System. out. pri ntl n(). Most 
programs input some data as well as generate output. There are lots of ways to input data in Java, but the 
simplest is to use a class Scanner provided in the package java, uti 1, as shown in the following example. 

// Area.java -reading from the keyboard 
import java.util 

class Area { 

public static void main (String[] args) 

{ 

double width, height, area; 

Scanner scan = new Scanner(System.in); 

System.out.println("type two doubles for the width and height of a rectangle"); 

width = scan.nextDoubleO ; 

height = scan.nextDoubleO; 

assert (width > 0 & height > 0); 

area = width * height; 

System.out.printC’The area is ") ; 

System.out.println(area); 

} 




Dissection of the Area Program 


• import java.util.*; 

This line tells the Java compiler that the program Si mpl elnput uses some of the classes defined in the 
package j ava .util. The * indicates that you might use any of the classes in the package. The class used 
here is Scanner. This class allows you to do simple terminal input. 

# Scanner scan = new Scanner(System.in); 

This creates the variable scan that is associated with System. i n. This makes the variable scan a proxy 
for using terminal input. 


Here is a table of some of the methods used for getting input from the terminal using a Scanner. As you can 
see the basic data types have a corresponding nextTypeQ method for reading and returning an input of that 
type. If the input is of the wrong type these methods fail and throw an exception. To avoid this, we can use 
methods of the form hasNextTypeQ that return true if the next input can be correctly interpreted. An exam¬ 
ple would be hasNextlnt () that checks that the input can be interpreted as an i nt. 


Scanner Method 

Explanation 

Examples 

nextlntO 

Integers expected 

123 -999 0 

nextDoubleO 

Doubles expected 

1.23 -0.01 

nextQ 

Arbitrary strings 

"Java" "123" 

nextBoolean() 

Logical values 

true false 

Scanner() 

i_-..• ..i 

Attaches source of input 

: new Scanner(System.in) 
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2.7 CALLING PREDEFINED METHODS 


A method is a group of instructions having a name. In the programs introduced so far, we’ve defined a single 
method called mai n(). In addition, we’ve used some methods from other classes that were standard Java 
classes. The methods have names, which makes it possible tor you to request the computer to perform the 
instructions that comprise the method. That’s what we’re doing by using the expression System.out. 
pri ntl n("Hel 1 o , worl d ! "). We’re calling a method with the name pri ntl n and asking that the instruc¬ 
tions be executed. Just as two people can have the same name, two methods can have the same name. We 
must therefore, in general, tell Java where to look for the method. Using System.out tells Java that we’re 
interested in the pri ntl n () method associated with the object identified by System. out. (We must still 
postpone a full explanation of the meaning of System. out.) As we have shown, the same method can be 
called several times in one program. In Simplelnput, we called the method println() twice. 

For many methods, we need to provide some data values in order for the method to perform its job. These 
values are provided to the method by placing them between parentheses following the name of the method. 
These values are called the parameters of the method, and we say that we are passing the parameters to the 
method. The pri ntl n () method requires one parameter, which is the value to be printed. As we indicated 
previously, this parameter can be either a string or a numeric value. In the latter case the numeric value will 
be converted by the pri ntl n() method to a string and then printed. If more than one parameter is required, 
we separate the parameter values by co mm as. For example, the predefined method Math. mi n () is used to 
determine the minimu m of two numbers. The following program fragment will print out 3. 

int numberOne = 10, numberTwo = 3, smallest; 
smallest = Math.min(numberOne, numberTwo); 

System.out.println(smallest); 

The method mi n () is contained in the standard Java class Math, which includes other common mathematical 
functions, such as Math. sqrt () that is used to find the square root of a number. 

<■ 

Here are some of the predefined methods that we’ve mentioned so far. 


System.out.print(x) 
System.out.println(x) 
scan.nextlnt() 
Math.min(x,y) 

Math.sqrt(x) 
wl.concat(w2) 
word.lengthQ 


//print the value of x 

//print the value of x followed by a newline 

//get an int from the keyboard 

//find the smaller of x and y 

//find the square root of x 

//concatenate the strings wl and w2 

//find the length of the string word 


Java includes a rich set of many more predefined methods. They include methods for the most common 
mathematical functions (see Appendix B, Reference Tables ), for creating graphical user interfaces (see Chap¬ 
ter 8 , Graphical User Interfaces: Part I and Chapter 9, Graphical User Interfaces: Part IT), for reading and writ¬ 
ing information from and to files (see Chapter 10, Reading and Writing Files), for communicating with 
programs on other computers using a network (see Chapter 13, Threads: Concurrent Programming ), and 
many more. An important aspect of Java is the ability to use parts of programs created by others. 
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2,8 printQ, println(), AND printf() 


The pri nt () and pri ntl n () methods can print all the primitive types. The method System. out. pri ntl n () 
is a convenient variant of System. out .pri nt () which appends a newline to the end of the output. You can 
always achieve the same effect by adding \n to the end of what is being printed. For example, the following 
two lines are equivalent. 

System.out.print("Hello, world!\n"); 

System.out.println("Hello, world!"); 

Recall, however, that you can’t put a an actual newline in the middle of a string, so the following would not 
be legal. 

System.out.println("type two integers for 

the width and height of a box"); 

In the same way that you can combine two strings with the string concatenation operator you can also com¬ 
bine one string and one value of any other type. In this case, the nonstring operand is first converted into a 
new string and then the two strings are concatenated. This allows rewriting the printing of the result in Area 
from Section 2.6, User Input, on page 23, in the form 

System.out.println("The area is " + area); 

This version emphasizes that one message will appear on a single line of the output. The doubl e value area 
is first converted to a Stri ng and then combined with the other string, using string concatenation. 

What about the opposite? What if you wanted to have an output message that spanned several output lines 
but with a single pri ntl n ()? You can do so by putting the symbols \n in a string literal to represent new¬ 
lines within the string. Such a string will print on more than one output line. Thus for 

System.out.println("One\nword\nper\nline."); 

The output is 


One 

word 

per 

line. 


The pair of symbols \n, when used in a string literal, mean to put a newline at this point in the string. This 
escape sequence allows you to escape from the normal meaning of the symbols \ and n when used sepa¬ 
rately. You can find out more about escape sequences in Section 2.9.3, The char Type , on page 29. 

Care must be taken when you’re using string concatenation to combine several numbers. Sometimes, paren¬ 
theses are necessary to be sure that the + is interpreted as string concatenation, not numeric addition. For 

int x = 1, y = 2; 

System.out.println("x + y = " + x + y); 

the output is x + y = 12 because the string "x + y =" is first concatenated with the string "l", and then 
2' is concatenated onto the end of the string "x + y = 1". To print x + y = 3 you should use parentheses 
first to force the addition of x and y as integers and then concatenate the string representation of the result 
with the initial string, as in 
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System.out.println("x + y = " + (x + y)); 

2.8.1 FORMATTING OUTPUT WITH printf () 

The method pri ntf () was introduced in Java 5.0. It provides formatted output as is done in C. The 
pri ntf C) method is passed a list of arguments that can be thought of as 

controLstring and other_arguments 

where controLstring is a string and may contain conversion specifications, or formats. A conversion specifi¬ 
cation begins with a % character and ends with a conversion character. For example, in the format 96s the let¬ 
ter s is the conversion character. 

pri ntf("%s", "abc"); 

The format 96s causes the argument "abc" to be printed in the format of a string. Yet another way to do this 
is with the statement 

printf ("96c%c%c" , ’a', 1 b', T c 1 ) ; 

Single quotes are used to designate character constants. Thus, ' a' is the character constant corresponding 
to the lowercase letter a. The format 96c prints the value of an expression as a character. Notice that a con¬ 
stant by itself is considered an expression. 
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as a character 
as a decimal integer 

as a floating-point number in scientific nota- 


9 


as a floating-point number 

in the e-format or f-format, whichever is 
shorter 

as a string 


When an argument is printed, the place where it is printed is called its field and the number of char¬ 
acters in its field is called its field width . The field width and a precision specifier can be specified in a 
format as two integers separated by a dot occurring between the 96 and the conversion character. Thus, 
the statement 

printf("Airfare is $%6.2f.\nParking is $%6.2f.\n M , 300.50, 16.50); 

specifies that the two numbers should be printed in a field of 6 characters with two digits (the precision) to 
the right of the decimal point. It will print 


Airfare is $300.50. 
Parking is $ 16.50. 


We will explain the various detailed conventions for using formats in Chapter 10, on page 304 
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2.9 NUMBER TYPES 


There are two basic representations for numbers in most modern programming languages: integer represen¬ 
tations and floating point representations. The integer types are used to represent integers or whole num¬ 
bers. The floating point types are used to represent numbers that contain fractional parts or for numbers 
whose magnitude exceeds the capacity of the integer types. 


2.9.1 THE INTEGER TYPES 

A bit is the smallest unit of information that can be stored in a computer. It can represent only two values, 
such as 1/0 or on/off or true/false. A sequence of bits can be used to represent a larger range of values. For 
the integer types, the bits are interpreted with the binary number system. The binary n um ber system has 
only two digits: 0 and 1. These two digits can be combined to represent any number in the same way that the 
10 digits of the normal, decimal number system can be combined to form any number. (See Appendix A, Get¬ 
ting Down to the Bits). 

Some mechanism is needed to represent positive and negative numbers. One simple solution would be to set 
aside one bit to represent the sign of the number. However, this results in two different representations of 
zero, +0, and -0, which causes problems for computer arithmetic. Therefore an alternative system called 
two’s complement is used. 

An 8-bit value called a byte can represent 256 different values. Java supports five integral numeric types. The 
type char, although normally used to represent symbolic characters in a 16-bit format called Unicode, can be 
interpreted as an integer. As discussed shortly, the result of combining a char value with another numeric 
value will never be of type char. The char value is first converted to one of the other numeric types. These 
types are summarized in the following table. 



Type 

| Number of Brfijf 

Range of Values 

byte 

8 

-128 to 127 

short 

16 

-32768 to 32767 

char 

16 

0 to 65536 

i nt 

32 

-2147483648 to 

2147483647 

long 

64 

-9223372036854775808 to 
9223372036854775807 


The asymmetry in the most negative value and the most positive value of the integer types results from the 
two’s complement system used in Java to represent negative values. 

Literal integer values are represented by a sequence of digits, possibly preceded by a minus sign. An integer 
literal is either an i nt or 1 ong. An explicit conversion, called a cast, of an i nt literal must be used to assign 
them to the smaller integer types short and byte (see Section 2.10.2, Type Conversion, on page 32). Integer 
literals can be expressed in base 10 (decimal), base 8 (octal), and base 16 (hexadecimal) number systems. 
Decimal literals begin with a digit 1-9, octal literals begin with the digit 0, and hexadecimal literals begin 
with the two-character sequence 0x. To specify a long literal instead of an i nt literal, append the letter el, 
uppercase or lowercase, to the sequence of digits. 

Here are some examples: 


• 217—the decimal value two hundred seventeen 
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# 0217—an octal number equivalent to 143 in the decimal system 
(2 x 8 2 + 1 x 8 1 + 7) 

# 0195 would be illegal because 9 is not a valid octal digit (only 0-7 are octal digits) 

# 0x217—*a hexadecimal number equivalent to 535 in the decimal system 
(2 x 16 2 1 1 x 16 1 + 7); 

the hexadecimal digits include 0-9 plus a= 10, b= 11, c= 12, d= 13, e = 14, and f = 15. 

% 14084 5912 3 4 L—a long decimal literal; without the L this would be an error because 14084591234 is too 

large to store in the 32 bits of an i nt type integer. 

2.9.2 THE FLOATING POINT TYPES 

Java supports two floating point numeric types. A floating point number consists of three parts: a sign, a 
magnitude, and an exponent. These two types are summarized in the following table. 


Tyi 
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PE 
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Number 
of Bits 

Approximate Range 

I-;:* d • r- rr-m 

of Values 

(■T 

xU :L;+ ; 

Approximate 

Precision 

• V 

. 

•, 

f 1 oat 

32 

+/-210 245 to +/-210+ 38 

7 decimal digits 

double 

64 

+/-210 2324 to +/-210 +308 

15 decimal digits 


To represent floating point literals, you can simply insert a decimal point into a sequence of digits, as in 
3.14159. If the magnitude of the number is too large or too small to represent in this fashion, then a nota¬ 
tion analogous to scientific notation is used. The letter e from exponent is used to indicate the exponent of 
10 as shown in the following examples. 


Java Representation 

Value 

■ 

2.17e-27 

2.17 x 1CT 27 

2.17e99 

2.17x10" 


Unless specified otherwise, a floating point literal is of type doubl e. To specify a floating point literal oJ type 
float, append either f or F to the literal—for example, 2.17e-27f. 


2.9.3 THE char TYPE 

Java provides char variables to represent and manipulate characters. This type is an integer type and can be 
mixed with the other integer types. Each char is stored in memory in 2 bytes. This size is large enough to 
store the integer values 0 through 65535 as distinct character codes or nonnegative integers, and these codes 
are called Unicode. Unicode uses more storage per character than previous common character encodings 
because it was designed to represent all the world’s alphabets, not just one particular alphabet. 

For English, a subset of these values represents actual printing characters. These include the lowercase and 
uppercase letters, digits, punctuation, and special characters such as % and +. The character set also includes 
the white space characters blank, tab, and newline. This important subset is represented by the first 128 
codes, which are also known as the ASCII codes. Ear her languages, such as C and C++, worked only with this 
more limited set of codes and stored them in 1 byte. 


The following table illustrates the correspondence between some character literals and integer values. Char¬ 
acter literals are written by placing a single character between single quotes, as in ' a'. 
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Some Character Constants and Their Corresponding Integer Values 

Character constants 

’a 1 ’b f *0’ ... 'z 1 

Corresponding values 

97 98 99 ... 122 

Character constants 

'A 1 ’B' 'C ... T Z' 

Corresponding values 

65 66 67 ... 90 

Character constants 

’0* f r 1 2* ... '9* 

Corresponding values 

48 49 50 ... 57 

Character constants 


Corresponding values 

38 42 43 


There is no particular relationship between the value of the character constant representing a digit and the 
digit’s intrinsic integer value. That is, the value of ' 2 ' is not 2. The property that the values for 'a', ' b', ’ c', 
and so on occur in order is important. It makes the sorting of characters, words, and lines into lexicographi¬ 
cal order convenient. 

Note that character literals are different from string literals, which use double quotes, as in "Hello". String 
literals can be only one character long, but they are still Stri ng values, not char values. For example, "a" is 
a string literal. 

Some nonprinting and hard-to-print characters require an escape sequence. The horizontal tab character, for 
example, is written as \t in character constants and in strings. Even though it is being described by the two 
characters \ and t, it represents a single character. The backslash character \ is called the escape character 
and is used to escape the usual meaning of the character that follows it. Another way to write a character 
constant is by means of a hexadecimal-digit escape sequence, as in ' \u0007 1 . This is the alert character, or 
the audible bell. These 4 hexadecimal digits are prefixed by the letter u to indicate their use as a Unicode lit¬ 
eral. The 65,536 Unicode characters can be written in hexadecimal form from '\u0000 1 to ’\uFFFF’. 

The following table contains some nonprinting and hard-to-print characters. 


Name of Character 

FvIvIvXviSJ:! : . • • . , . • • • ‘ ! ! ! . i . . 1 I;. ! !v -F. 

Escape 

1NT 

HEX 
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Backslash 

w 

92 

\u005C 

Backspace 

\b 

8 

\u0008 

Carriage return 

\r 

13 

\u000D 

Double quote 

\" 

34 

\u0022 

Formfeed 

\f 

12 

\u000C 

Horizontal tab 

\t 

9 

\u0009 

Newline 

\n 

10 

\u000A 

Single quote 

V 

39 

\u0027 

Null character 


0 

\u0000 

Alert 


7 

\u0007 


The alert character is special; it causes the bell to ring. To hear the bell, try 7 executing a program that contains 
the line 

System.out.print(’\u0007'); 


Character values are small integers, and, conversely, small integer values can be characters. Consider the dec¬ 
laration 
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char c = 'a'; 

The variable c can be printed either as a character or as an integer: 

System.out.printf(“%c”,c); // a is printed 

System.out.printf(“%d”,c); // 97 is printed 


2.9.4 NUMBERS VERSUS STRINGS 

The sequence of Os and Is inside a computer used to store the Stri ng value n 1234 " is different from the 
sequence of Os and Is used to store the i nt value 1234, which is different from the sequence of Os and Is 
used to store the doubl e value 12 34.0. The string form is more convenient for certain types of manipula¬ 
tion, such as printing on the screen or for comb inin g with other strings. The i nt form is better for some 
numeric calculations, and the double form is better for others. So how does the computer know how to inter¬ 
pret a particular sequence of Os and Is? The answer is: Look at the type of the variable used to store the 
value. This answer is precisely why you must specify a type for each variable. Without the type information 
the sequence of Os and 1 s could be misinterpreted. 

We do something similar with words all the time. Just as computers interpret sequences of Os and Is, human 
beings interpret sequences of alphabetic symbols. How people interpret those symbols depends on the con¬ 
text in which the symbols appear. For example, at times the same word can be a noun, and at other times it 
can be a verb. .Also, certain sequences of letters mean different things in different languages. Take the word 
pie for example. What does it mean? If it is English, it is something good to eat. If it is Spanish, it means foot. 

From the context of the surrounding words we can usually figure out what the type of the word is: verb or 
noun, English or Spanish. Some programming languages do something similar and “figure out” the type of a 
variable. These programming languages are generally considered to be more error prone than languages such 
as Java, which require the progr amm er to specify the type of each variable. Languages such as Java are called 
strongly typed languages. 



2.10 ARITHMETIC EXPRESSIONS 


The basic arithmetic operators in Java are addition +, subtraction -, multiplication *, division /, and 
modulus %. You can use all arithmetic operators with all primitive numeric types: char, byte, short, i nt, 
1 ong, f 1 oat , and doubl e. In addition, you can combine any two numeric types by using these operators in 
what is known as mixed mode arithmetic. Although you can use the operators with any numeric type, Java 
actually does arithmetic only with the types i nt, 1 ong, f 1 oat, and doubl e. Therefore the following rules are 
used first to convert both operands into one of four types. 

1. If either operand is a doubl e, then the other is converted to doubl e. 

2. Otherwise, if either operand is a f 1 oat, then the other is converted to f 1 oat. 

3. Otherwise, if either operand is a 1 ong, then the other is converted to a 1 ong. 

4. Otherwise, both are converted to i nt. 

Tills conversion is called binary numeric promotion and is also used with the binary relational operators dis¬ 
cussed in Section 3.2.1, Relational and Equality Operators , on page 49. 

When both operands are integer types, the operations of addition, subtraction, and multiplication are self- 
evident except when the result is too large to be represented by the type of the operands. 

Integer values can’t represent fractions. In Java, integer division truncates toward 0. For example, 6 / 4 is 1 
and 6 / (-4) is -1. A common mistake is to forget that integer division of nonzero values can result in 0. To 
obtain fractional results you must force one of the operands to be a floating point type. In expressions 
involving literals you can do so by adding a decimal point, as in 6.0 / 4, which results in the floating point 
value 1.5. In addition, integer division by zero will result in an error called an Ari thmeti cExcepti on. An 
exception , as the name implies, is something unexpected. Java provides a way for you to tell the computer 
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what to do when exceptions occur. If you don’t do anything and such an error occurs, the program will print 
an appropriate error message and terminate. We discuss exceptions in Chapter 11, Coping with Errors. 

Unlike some programming languages, Java doesn’t generate an exception when integer arithmetic results in a 
value that is too large. Instead, the extra bits of the true result are lost, and in some cases pollute the bit used 
for the sign. For example, adding two very 7 large positive numbers could generate a negative result. Likewise, 
subtracting a very large positive number from a negative number could generate a positive result. If values 
are expected to be near the limit for a particular type, you should either use a larger type or check the result 
to determine whether such an overflow has occurred. 

When one of the operands is a floating point type, but both operands are not of the same type, one of them is 
converted to the other as described earlier. Unlike some progr ammin g languages, floating point arithmetic 
operations in Java will never generate an exception. Instead three special values can result: positive infinity, 
negative infinity, and “Not a Number.” See Appendix A, Getting Down to the Bits for more details. 

The modulus operator % returns the remainder from integer division. For example, 16 % 3 is 1, because 16 
divided by 3 is 5 with a remainder of 1. The modulus operator is mostly used with integer operands; how¬ 
ever, in Java it can be used with floating point operands. For floating point values x % y is n, where n is the 
largest integer such that | y | * n is less than or equal to | x |. 


2.10.1 AN INTEGER ARITHMETIC EXAMPLE: CHANGE 

The computation in Section 1.3, Implementing Our Algorithm in Java, on page 5, whereby we made change 
for a dollar, is a perfect illustration of the use of the two integer division operators, / and %. 

// MakeChange.java - change in dimes and pennies 
import java.uti1.*; 

class MakeChange { 

public static void main (String[] args) { 
int price, change, dimes, pennies; 

Scanner scan = new Scanner(System.in); 

System.out.println("type price (0 to 100):”); 
price = scan.nextlnt(); 

change = 100 - price; //how much change 

dimes = change / 10; //number of dimes 

pennies = change % 10; //number of pennies 

System.out.print("The change is : "); 

System.out.println(dimes + ” dimes ” + pennies + " pennies"); 

} 

} 




Dissection of the MakeChange Program 


# int price, change, dimes, pennies; 

This program declares four Integer variables. These types determine the range of values that can be used 
with these variables. They also dictate that this program use Integer arithmetic operations, not floating 
point operations. 

• price * scan.nextlntQ; 

The scan. nextlnt () is used to obtain the input from the keyboard. The nextlnt () method is a mem¬ 
ber of the class Scanner. At this point we must type in an integer price. For example, we would type 77 
and hit Enter. 
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# change = 100 - price; //how much change 

This line computes the amount of change. This is the integer subtraction operator. 


# dimes = change / 10; //number of dimes 

pennies - change % 10; //number of pennies 

To compute the number of dimes, we compute the integer result of dividing change by 10 and throw 
away any remainder. So if change is 23, then the integer result of 23/10 is 2. The remainder 3 is dis¬ 
carded. The number of pennies is the integer remainder of change divided by 10. The % operator is the 
integer remainder or modulo operator in Java. So if change is 23, then 23 % 10 is 3. In Exercise 17 on 
page 43, we ask you to use double for the variables and to report on your results. 



2.10,2 TYPE CONVERSION 

You may want or need to convert from one primitive numeric type to another. As mentioned in the preceding 
section, Java will sometimes automatically convert the operands of a numeric operator. These automatic con¬ 
versions are also called widening primitive conversions. These conversions always convert to a type that 
requires at least as many bits as the type being converted, hence the term widening. In most but not all cases, 
a widening primitive conversion doesn’t result in any loss of information. An example of a widening primi¬ 
tive conversion that can lose some precision is the conversion of the i nt value 123456789 to a f 1 oat value, 
which results in 123456792. To understand this loss of information, see Appendix A, Getting Down to the 
Bits. The following are the possible widening primitive conversions:. 


From 

Tn 

; ||p 1 u 


byte 

short, i nt, 1 ong, f 1 oat, or double 

short 

i nt, 1 ong, f 1 oat, or doubl e 

char 

i nt, 1 ong, f 1 oat, or doubl e 

i nt 

long, float, or double 

long 

float or double 

float 

double 


In addition to performing widening conversions automatically as part of mixed mode arithmetic, widening 
primitive conversions are also used to convert automatically the right-hand side of an assignment operator 
to the type of the variable on the left. For example, the following assignment will automatically convert the 
integer result to a floating point value. 

int x = 1, y = 2; 
float z; 

z = x + y; // automatic widening from int to float 


A narrowing primitive conversion is a conversion between primitive numeric types that may result in signifi¬ 
cant information loss. The following are narrowing primitive conversions. 
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I From 

[ : JK 'ft 

fi 

.-.-.V. 

t a 

; i : l' ' ::::: "V :: - :x X 

byte 

char 

short 

byte or char 

char 

byte or short 

i nt 

byte, short, or char 

long 

byte, short, char, or int 

fl oat 

byte, short, char, int, or long 

double 

byte, short, char, int, long, or float 


Narrowing primitive conversions generally result only from an explicit type conversion called a cast A cast is 
written as (type) expression, where the expression to be converted is preceded by the new type in parenthe¬ 
ses. A cast is an operator and, as the table in Section 2.13, Precedence and Associativity of Operators, on page 
38, indicates, has higher precedence than the five basic arithmetic operators. For example, if you are inter¬ 
ested only in the integer portion of the floating point variable someFloat, then you can store it in some- 
integer, as in 

int somelnteger; 

float someFloat = 3.14159; 

somelnteger = (int)someFloat; 

System.out.println(somelnteger); 

The output is 


3 


If the cast is between two integral types, the most significant bits are simply discarded in order to fit the 
resulting format. This discarding can cause the result to have a different sign from the original value. The fol¬ 
lowing example shows how a narrowing conversion can cause a change of sign. 

int i = 127, j = 128; 

byte iAsByte = (byte)i, jAsByte = (byte)j; 

System. out .pri ntl n(i AsByte); 

System. out .println(jAsByte); 

The output is 


127 

-128 


The largest positive value that can be stored inabyteis 127. Attempting to force a narrowing conversion on 
a value greater than 127 will result in the loss of significant information. In this case the sign is reversed. To 
understand exactly what happens in this example, see Appendix A. 
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Common Programming Error 

Remember that integer division truncates toward zero. For example, the value of the expression 3/4 is 0. 
Both the numerator and the denominator are integer literals, so this is an integer division. If what you 
want is the rounded result, you must first force this to be a floating point division and then use the rou¬ 
tine Math. round () to round the floating point result to an integer. To force a floating point division you 
can either make one of the literals a floating point literal or use a cast. In the following example first 
recall that floating point literals of type f 1 oat are specified by appending the letter f. Then for 

int x = Math. round(3,0f/4); 

the variable x will get the value 1. Forcing the division to be a floating point divide is not enough. In the 
following example, z will be 0. 

int z - (int)(3.0f/4) ; 

The conversion of 0.75 to an i nt truncates any fractional part. 
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2.11 ASSIGNMENT OPERATORS 


To change the value of a variable, we have already made use of assignment statements such as 
a = b + c; 

Assignment is an operator, and its precedence is lower than all the operators we’ve discussed so far. The 
associativity for the assignment operator is right to left. In this section we explain in detail its significance. 

To understand = as an operator, let’s first consider + for the sake of comparison. The binary operator + takes 
two operands, as in the expression a + b. The value of the expression is the sum of the values of a and b. By 
comparison, a simple assi gnm ent expression is of the form 

variable = rightHandSide 

where rightHandSide is itself an expression. A semicolon placed at the end would make this an assignment 
statement. The assignment operator = has the two operands variable and rightHandSide. The value of right¬ 
HandSide is assigned to variable , and that value becomes the value of the assignment expression as a whole. 
To illustrate, let’s consider the statements 

b = 2; 
c = 3; 
a = b + c; 

where the variables are all of type int. By making use of assignment expressions, we can condense these 
statements to 

a = (b = 2) + (c = 3) ; 

The assignment expression b - 2 assigns the value 2 to the variable b, and the assignment expression itself 
takes on this value. Similarly, the assignment expression c - 3 assigns the value 3 to the variable c, and the 
assignment expression itself takes on this value. Finally, the values of the two assignment expressions are 
added, and the resulting value is assigned to a. 

Although this example is artificial, in many situations assignment occurs naturally as part of an expression. 
A frequently occurring situation is multiple assignment. Consider the statement 
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a = b = c = 0; 

Because the operator = associates from right to left, an equivalent statement is 
a = (b = (c = 0)) ; 

First, c is assigned the value 0, and the expression c = 0 has value 0. Then b is assigned the value 0, and the 
expression b = (c = 0) has value 0. Finally, a is assigned the value 0, and the expression 
a - (b = (c = 0)) has value 0. 

In addition to =, there are other assignment operators, such as += and -=. An expression such as 
k = k + 2 

will add 2 to the old value of k and assign the result to k, and the expression as a whole will have that value. 
The expression 

k -h= 2 

accomphshes the same task. The following hst contains all the assignment operators 
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All these operators have the same precedence, and all have right-to-left associativity. The meaning is speci¬ 
fied by 

variable op = expression 

which is equivalent to 

variable = variable op ( expression ) 

%' 

with the exception that if variable is itself an expression, it is evaluated only once. Note carefully that an 
assignment expression such as 

j *= k + 3 is equivalent to j = j*(k + 3) 

rather than 


j = j * k + 3 



are evaluated. 


Declarations and Initializations 

. ■ •• . . • 

int 1=1, 3=2, k = 3, m = 4; 

:: : : : : : :: : : : 

> • . j 

: 

:: : : 

Expression 

Equivalent Expression 

Equivalent Expression 

Value 

i += j + k 

j *= k = m + 5 

i += (j + k) 

j *= (k = (m + 5)) 

i = (i + Cj + k)) 

j = Cj * (k = (m + 5))) 

6 

18 
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2.12 THE INCREMENT AND DECREMENT OPERATORS 


Computers are very good at counting. As a result, many programs involve having an integer variable that 
takes on the values 0, 1, 2,.. . One way to add 1 to a variable is 

i = i -hi; 

which changes the value stored in the variable i to be 1 more than it was before this statement was executed. 
This procedure is called incrementing a variable. Because it is so common, Java, like its predecessor C, 
includes a shorthand notation for incrementing a variable. The following statement gives the identical result. 

i++; 

The operator ++ is known as the increment operator. Similarly, there is a decrement operator, —, so that the 
following two statements are equivalent: 

i — i - 1; 

Here is a simple program that demonstrates the increment operator. 

//Increment.java - demonstrate incrementing 
class Increment { 

public static void main(String[] args) { 
int i = 0; 


System. 

out. 

. pri 

ntl 

n("i 

= " + 

i); 

in J i 

ii 

_i. 

4- 

1; 






System. 

out. 

.pri 

ntl 

n("i 

- " + 

* i»i 

p p 

* 

i++; 







System. 

out. 

.pri 

ntl 

n("i 

= " + 

i); 

i++; 







System. 

out. 

.pri 

ntl 

n("i 

- " + 

i); 


} 

} 

The output of this program is 



Note that both increment and decrement operators are placed after the variable to be incremented. When 
placed after its argument they are called the postfix increment and postfix decrement operators. These opera¬ 
tors also can be used before the variable. They are then called the prefix increment and prefix decrement 
operators. Each of the expressions ++i (prefix) and i ++(postfix) has a value; moreover, each causes the stored 
value of i in memory to be incremented by 1. The expression ++i causes the stored value of i to be incre¬ 
mented first, with the expression then taking as its value the new stored value of i. In contrast, the expres¬ 
sion i ++ has as its value the current value of i; then the expression causes the stored value of i to be 
incremented. The following code illustrates the situation. 
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int a, b, c = 0; 

a = ++c; 

b = C++; 

System.out.println("a = " + a) ; //a = 1 is printed 

System.out.println("b = " + b); //b - 1 is printed 

System.out.println( M c = " + ++c); //c = 3 is printed 

Similarly, --i causes the stored value of i in memory to be decremented by 1 first, with the expression then 
taking this new stored value as its value. With i — the value of the expression is the current value of i; then 
the expression causes the stored value of i in memory to be decremented by 1. Note that ++ and -- cause the 
value of a variable in memory to be changed. Other operators do not do so. For example, an expression such 
as a + b leaves the values of the variables a and b unchanged. These ideas are expressed by saying that the 
operators ++ and -- have a side effect, not only do these operators yield a value, but they also change the 
stored value of a variable in memory. Of course this is also true of the assignment operator. 

In some cases we can use ++ in either prefix or postfix position, with both uses producing equivalent results. 
For example, each of the two statements 

++i ; and i++; 

is equivalent to 

i = i +1; 

In simple situations you can consider ++ and - -as operators that provide concise notation for the incre¬ 
menting and decrementing of a variable. In other situations, you must pay careful attention as to whether 
prefix or postfix position is used. 
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2.1 3 PRECEDENCE AND ASSOCIATIVITY OF OPERATORS 


When evaluating expressions with several operators, you need to understand the order of evaluation of each 
operator and its arguments. Operator precedence gives a hierarchy that helps determine the order in which 
operations are evaluated. For example, precedence determines which arithmetic operations are evaluated 
first in 

x = (~b + Math.sqrt(b * b - 4 * a * c))/(2 * a) 

which you may recognize as the expression to compute one of the roots of a quadratic equation, written like 
this in your mathematics class: 


_ - b + yb - 4ac 

A 

2a 

To take a simpler example, what is the value of integer variable x after the assignment x = 7 + 5 * 3? The 
answer is 22, not(7 + 5) x 3 which is 36. The reason is that multiplication has higher precedence than addi¬ 
tion; therefore 5 * 3 is evaluated before 7 is added to the result. 

In addition to some operators having higher precedence than others, Java specifies the associativity or the 
order in which operators of equal precedence are to be evaluated. For example, the value of 100 / 5 * 2 is 
40, not 10. This is because / and * have equal precedence and arithmetic operators of equal precedence are 
evaluated from left to right. If you wanted to do the multiplication before the division, you would write the 
expression as 100 / (5 * 2). Parentheses can be used to override the normal operator precedence rules. 

This left to right ordering is important in some cases that might not appear obvious. Consider the expression 
x + y + z. From simple algebra, the associativity of addition tells us that (x + y) + z is the same as 
x + (y + z). Unfortunately, this is true only when you have numbers with infinite precision. Suppose that y 
is the largest positive integer that Java can represent, x is -100, and z is 50. Evalua tin g (y + z) first will 
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result in integer overflow, which in Java will be equivalent to some very large negative number, clearly not 
the expected result. If instead, (x + y) is evaluated first, then adding z will result in an integer that is still in 
range and the result will be the correct value. 

The precedence and associativity of all Java operators is given in Appendix Appendix B, Reference Tables. 
The following table gives the rules of precedence and associativity for the operators of Java that we have 
used so far. 


Operator Precedence and Associativity 

/&.. ■ 

: ‘ • : . . * ! . . : : •: 

Operator ggii-; 

Associativity 

( ) ++ (postfix) -- (postfix) 

Left to right 

+ (unary) - (unary) ++ (prefix) - - (prefix) 

Right to left 

new (type)expr 

Right to left 

/ % 

Left to right 

+ ~~ 

Left to right 

+= -*= *= /= etc. 

Right to left 


All the operators on the same line, such as *, /, and %, have equal precedence with respect to each other but 
have higher precedence than all the operators that occur on the lines below them. The associativity rule for 
all the operators on each line appears in the right-hand column. 

In addition to the binary +, which represents addition, there is a unary +, and both operators are represented 
by a plus sign. The minu s sign also has binary and unary meanings. The following table gives some additional 
examples of precedence and associativity of operators. 




2.14 PROGRAMMING STYLE 


A clear, consistent style is important to writing good code. We use a style that is largely adapted from the 
Java professional programming community. Having a style that is readily understandable by the rest of the 
programming community is important. 

We’ve already mentioned the importance o comments for documenting a program. Anything that aids in 
explaining what is otherwise not clear in the program should be placed in a comment. Comments help the 
programmer keep track of decisions made while writing the code. Without good documentation, you may 
return to some code you have written, only to discover that you have forgotten why you did some particular 
thing. The documentation should enable someone other than the original programmer to pick up, use, and 
modify the code. All but the most trivial methods should have comments at the beginning, clearly stating the 
purpose of the method. Also, complicated blocks of statements should be preceded by comments summariz- 
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ing the function of the block. Comments should add to the clarity of the code, not simply restate the pro¬ 
gram, statement by statement. Here is an example of a useless comment. 

area = width * height; // compute the area 

Good documentation includes proper choice of identifiers. Identifiers should have meaningful names. Cer¬ 
tain simple one-character names are used to indicate auxiliary variables, such as i, j, or k, as integer vari¬ 
ables. 

The code should be easy to read. Visibility is enhanced by the use of white space. In general, we present only 
one statement to a line and in all expressions separate operators from arguments by a space. As we progress 
to more complex programs, we shall present, by example or explicit mention, accepted layout rules for pro¬ 
gram elements. 

Some naming conventions used by many Java programmers 

• Class names start with uppercase and embedded words, as in Hel 1 oWorl d, are capitalized. 

• Methods and variables start with lowercase and embedded words, as in readlnt, data, 
toString, and looplndex, are capitalized. 

% Although legal, the dollar sign, $, should not be used except in machine-generated Java pro¬ 
grams. 



Summary 


• To create a Java program first define a class. Give the class a method called main(). Put whatever 
instructions you want the computer to execute inside the body of the method mai n (). 

• A program stores data in variables. Each variable is given a type, such as int for storing integers or 
Stri ng for storing strings. 

• You can use literals to embed constant values of various types in a program, such as in the constant 
string "Hello, world!" or the integer constant 3. 

• You can combine literals and variables in expressions by using operators such as + for addition or string 
concatenation and * for numeric multiplication. 

• You can store the result of evaluating an expression in a variable by using the assignment operator =. 
The variable is always on the left, and the expression being assigned to the variable is always on the 
right. 

• You can call a method from another class by writing the name of the class followed by a dot and the 
name of the method—for example, Math. sqrt (). 

• The lexical elements of a Java program are keywords, identifiers, literals, operator symbols, punctuation, 
comments, and white space. 

• You can print strings and numbers to the screen by using the method System.out.printQ or Sys¬ 
tem . out - pri ntl n O. The latter appends a newline to whatever is printed. These methods are part of the 

standard Java classes. Java 5.0 introduced pri ntf () which allows formatted printing as derived from 
the C language. 

• You can input from the keyboard by using the methods of class Scanner. These include next() for 
strings, nextlntQ for integers and nextDoubleO for doubles. 

• Java supports the primitive integer types char, byte, short, i nt, and 1 ong. It also supports two floating 
point types, f 1 oat and doubl e. 
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O Integer division truncates toward zero—it doesn’t round to the nearest whole number. You can use 
Math. round () if rounding is what you want. 



Review Questions 

1. What line appears in every complete Java program indicating where to begin executing the program? 

2. What one-line instruction would you use to have a Java program print Goodbye? 

3. What affect do strings such as /* what i s thi s V have on the execution of a Java program? 

4. What is a variable? 

5. What is a method? 

6. Complete the following table. 


Text 

Legal ID 

WHY OR WHY NOT 

3xyz 

No 

Digit is first character. 

xy3z 



a = b 



mai n 



Count 



class 




7. What does the symbol = do in Java? 

8. Programmers say_a method when they mean go and execute the instructions for the method. 

9. True or false? A multiline comment can be placed anywhere white space could be placed. 

10. True or false? Keywords can also be used as variables, but then the special meaning of the keyword is 
overridden. 

11. What convention for identifiers given in this chapter is used in whatAml, howAboutThi s, someName? 

12. What p rimi tive types are used to store whole numbers? 

13. What is the difference between x = 'a' and x = a? 

14. What is the difference between s = "hello” and s = hello? 

15. Which version of the Java program Hel 1 oWorl d is the one you can view and edit with a text editor, Hel - 
loWorldJava or HelloWorld.class ? What does the other one contain? What program created the one you do 

not edit? 

16. What is Unicode? 

17. list the primitive types in Java. 

18. Before it can be used, every variable must be declared and given a-. 
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19. What is the value of the Java expression "10'V20"? Don’t ignore the quotation marks; they are crucial. 

20. Write a Java statement that could be used to read an integer value from the keyboard and store it in the 
variable someNumber. 

21. What is wrong with the following Java statement? 

System.out.printlnC’This statement is supposed 
to print a message. What is wrong?"); 

22. Every group of input statements should be preceded by what? 

23. How do you write x times y in Java? 

24. What is the difference between System.out. pri nt("message") and System.out. print!n( n mes- 
sage")? 


25. Write a single Java statement that will produce the following output. 


X 

XX 

XXX 


26. Approximately, what is the largest value that can be stored in the primitive type i nt? One thousand? One 
million? One billion? One trillion? Even larger? 

27. What primitive Java type can store the largest numbers? 

28. What is the value of the following Java expressions? 

20 / 40 
6/4 
6.4 / 2 



tXERCISES 


1. Write a Java program that prints “Hello your name." You can do this by a simple modification to the He! - 
1 oWorl d program. Compile and run this program on your computer. 

2. Write a Java program that prints a favorite poem of at least eight lines. Be sure to print it out neatly 
aligned. At the end of the poem, print two blank lines and then the author’s name. 

3. Design your own signature logo, such as a sailboat icon if you like sailing, and print it followed by “yours 
truly —your name.” A sailboat signature logo might look like 

A 

/ \ 

/ \ 

/ \ 


\ Yours truly / 
Bruce McPohl 
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4. Write a Java program to read in two numbers and print the sum. Be sure to include a message to prompt 
the user for input and a message identifying the output. See what happens if you type in something that 
is not a number when the program is run. See how large a number you can type in and still have the pro¬ 
gram work correctly. 

5. The following code contains three syntax errors and produces two syntax error messages from javac. Fix 
the problems. 

// Ch2el.java - fixing syntax errors 
Class Ch2el { 

public static void main(String[] args) { 

System.out.println(hello, world); 

} 

The javac compiler’s message reads: 


Ch2el.java:2: Cl ass or interface declaration 
expected. 

Class ch2el { 

A 

Ch2el.java:7: Unbalanced parentheses. 

A 

2 errors 


6. The following code produces one syntax error message from javac. Fix the problem. 

// Ch2e2.java - more syntax errors 
class Ch2e2 { 

public static void main(String[] args) { 
int count = 1, i = 3, 

System.out.println("count + i = ", count + i); 

} 

} 

The javac compiler’s message reads 


Ch2e2.j ava:6: Invalid declaration. 

System.out.println("count + i = ", count + i); 


Here, unlik e the previous exercise, the compiler doesn’t as clearly point to the errors. Frequently, errors 
in punctuation lead to syntax error messages that are hard to decipher. After you fix the first syntax 
error in the code, a second error will be identified. 


7. Continue with the code class Ch2e2. If you fixed just the syntax errors, you may get a running program 
that still has a run-time bug. Namely, the output may not be the sum of count + i. Fixing run-time or 
semantic bugs is harder than fixing syntax bugs because something is wrong with your understanding of 
how to program the solution. Without introducing any other variables fix the run-time bug. 


8. Write a program that draws a box like the one shown, using a single printlnQ statement. 
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9. Use scan. nextDouble() to read In one double precision floating point n umb er and then print the 
results of calling Math.sinQ, Math.cosQ, Math.asinQ, Math.expO, Math, log (), Math. f'1 oor(), 
and Math. round () with the input value as a parameter. Be sure to prompt the user for input and label 
the output. 

10. Write a program to read two double precision floating point numbers, using nextDoubleQ. Print the 
sum, difference, product, and quotient of the two numbers. Try two very small numbers, two very large 
numbers, and one very small number with one very large number. You can use the same notation used 
for literals to enter the numbers. For example, 0.12 3e- 310 is a very small n umb er. 

11. Write a program to compute the area of a circle given its radius. Let radi us be a variable of type doubl e 
and use nextDoubleQ to read in its value. Be sure that the output is understandable. The Java class 
Math contains definitions for the constants E and PI, so you can use Math. PI in your program. 

12. Extend the previous program to write out the circumference of a circle and the volume of a sphere given 
the radius as input. Recall that the volume of a sphere is 

, 3 

Y _ 4 x jtr 

3 

13. Write a program that asks for a double and then prints it out. Then ask for a second double, this time 
printing out the sum and average of the two doubl es. Then ask for a third double and again print out the 
accumulated sum and the average of the three doubles. Use variables datal, data2, data3, and sum. 
Later, when we discuss loops, you will see how this is easily done for an arbitrary 7 number of input val¬ 
ues. 

14. Write a program that reads in an integer and prints it as a character. Remember that character codes can 
be nonprinting. ‘ 

15. Write a program that asks for the number of quarters, dimes, nickels, and pennies you have. Then com¬ 
pute the total value of your change and print the number of dollars and the rem ainin g cents. 

16. Write a program capable of converting one currency to another. For example, given U.S. dollars it should 
print out the equivalent number of Euros. Look up the exchange rate and use it as input. 

17. Change the MakeChange program to use variables that are doubl es. Run the program and see what goes 
wrong. 

class MakeChange { 

public static void main (String[] args) { 
double price, change, dimes, pennies; 


18. The following is a C program for printing “Hello, world!”. 

/* Hello World In C 

* Purpose: 

- The classic "Hello, world!" program. 

* It simply prints a message to the screen. 

* Author: 

* Jane Programmer 

* as derived from Kernighan and Richie 

V 
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#inc1ude <stdio.h> /* needed for 10 */ 
int main(void) { 

printf("Hello, world!\n"); 

return 0; /* unneeded in Java */ 

} 

Note how similar this program is to the Java version. A key difference is the lack of class encapsulation 
of mai n(). As in Java, mai n() starts the program’s execution. In C, methods are known as functions. The 
pri ntf () function is found in the standard input-output library imported by the C compiler for use in 
this program. The return 0 ends program execution and is not used in Java. Convert the following C 
program to Java. 

#include <stdio.h> 
int main(void) { 

pri ntf ("Hel lo, world!\n f '); 
printf("My name is George.\n"); 
printf("Yada Yada Yada ...\n"); 
return 0; 

} 



Applet Exercise 


The following program is an example of a Java applet. This program uses several features of Java that we 
explain later. Note that there is no method mai n (); instead there is the method pai nt (). For now just con¬ 
centrate on the body of the method pai nt(), treating the surrounding code as a template to be copied verba¬ 
tim. By invoking the appropriate drawing operations on the Graphi cs object g, you can draw on the applet. 

/* To place this applet in a web page, add the 

following two lines to the html document for the 
page. 

capplet code="FirstApplet.class" 
width=500 hei ght=200x/applet> 

*/ 

// AWT and Swing together comprise the collection of 
// classes used for building graphical Java programs 
import java.awt.*; //required for programs that draw 
import javax.swing.*; //required for Swing applets 
public class FirstApplet extends JAppJet { 
public void paint(Graphics g) { 

// draw a line from the upper left corner to 
// 100 pixels below the top center of the Applet 
g.drawLine(0,0,250,100); 

// draw a line from the end of the previous line 
// up to the top center of the Applet 
g.drawLine(250,100,250,0); 

// draw an oval inscribed in an invisible 
// rectangle with its upper left corner at the 
// intersection of the two lines drawn above 
g.d rawOval(250,100,200,100); 

} 

} 


The class Graphi cs is used for simple drawing, and many drawing operations are defined for it. In this exam¬ 
ple we use the method d rawLi ne () to draw a line. The first two numbers in parentheses for the drawl i ne () 
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operation are the xy coordinates of one end of the line, and the last two numbers are the xy coordinates of 
the other end. As you can see from the output of the program, the location (0, 0) is in the upper left comer, 
with increasing x moving to the right and increasing y moving down. To draw an oval, give the coordinates of 
the upper left corner and the width and height on an invisible rectangle. The oval will be inscribed inside the 
rectangle. 

To execute an applet, first compile it like you do other Java programs. Then you can either run the program 
appletviewer or use a web browser to view the applet. To view the applet Fi rstApp] et using the applet- 
viewer on Unix and Windows machines, type the following at a command line prompt. 

appletviewer Fi rstApp]et.java 

Notice that we are passing Fi rstApp] et. java— not Fi rstApplet or Fi rstApp] et . c] ass— to the applet- 
viewer. This procedure is different from running regular Java programs. In fact app] etvi ewer just looks in 
the text file passed to it for an applet element. An applet element begins with <appl et> and ends with </ 
app] et>. Any text file containing the applet element shown in the opening comment for Fi rstApp] et. java 
would work just as well. 

To view the applet in a Web browser, create a file—for example, Fi rstApp] et. html . Put the applet tag in 
the html file. Put the html file in the same directory as your applet and then open the html file with a Web 
browser. 

The applet looks like the following when run with an app] etvi ewer. 



mm 




Applet started 


..---. 




...-----.. 




Applet Viewer: FirstApplet.class 


Modify this applet to draw a simple picture. Look up the documentation for Graphi cs on the Web at 
http://java. sun.com/j2se/l. 5.0/docs/api/java/awt/Graphi cs .html 
and use at least one method/operation of Graphi cs not used in Fi rstAppl et. 
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The program examples presented until now have executed from top to bottom without making any decisions. 
In this chapter, we have programs select among two or more alternatives. We also demonstrate how to write 
programs that repeatedly execute the same sequence of instructions. Both instructions to computers and 
instructions in everyday life are filled with conditional and iterative statements. A conditional instruction for 
your microwave oven might say “If you wish to defrost press the defrost button; otherwise, press the full 
power button.” An iterative instruction for baking a loaf of bread might say “Let the dough rise in a warm 
place until it has doubled in size.” Conditional and iterative statements are controlled by boolean expres¬ 
sions. A boolean expression is either true or false. “If it is raining, wear your raincoat” is an instruction given 
by many parents and is followed if it is true that it is raining. In Java, expressions that evaluate as true or 
false are of type boolean. To direct the flow of control properly you need to learn how to write bool ean 
expressions. 



3.1 
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EXPRESSION, BLOCK, AND EMPTY STATEMENTS 


Java has many kinds of statements. Most of the statements that we have shown have specified the evaluation 
of an expression. We’ll soon look at statements that select between two alternatives and statements that 
repeat many times. Before doing that, we need to look more closely at the statements that we have been 
using. The normal flow of instructions in Java is to execute the statements of the program in sequential order 
from top to bottom. 

All the statements used so far have been either variable declaration statements or expression statements. 
Variable declaration statements begin with a type, such as i nt or Stri ng, and end with a semicolon, as in 


int width, height, area; 
String hello = "Hello, world! 
double size = 1.5, x; 


ii 


The first declares three variables of type i nt. The second declares one variable of type Stri ng and initializes 
it. The third declares and initializes the variable si ze, but not the variable x. Declaration statements start 
with a type and are followed by one or more variables, separated by commas. The variables may be initialized 
by using the equals sign followed typically by a literal. In Java all variables need to be declared. 


Expression statements are formed by adding a semicolon to the end of an expression. Expressions are basic 
to performing computations. Not all expressions are valid in expression statements. The two types of expres¬ 
sions used so far that are valid in expression statements are assignment expressions and method call expres- 
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sions. An assignment expression is any expression involving the assignment operator. A method call 
expression does not involve an assignment operator. The following are examples of expression statements. 

area = width * height; //simple assignment statement 
System.out.printing..); //method call expression 

A statement used for grouping a number of statements is a block. A block is a sequence of one or more state¬ 
ments enclosed by braces. A block is itself a statement. A simple example is 

{ 

x = 1; 

y = 2 * x + 1; 

System.out.println(y); 

System.out.println(x); 

} 

Statements inside a block can also be blocks. The inside block is called an inner block , which is nested in the 
outer block. .An example is 

{ //outer block 
x = 1; 

{ //inner block 
y - 2; 

System.out.println(y); 

} //end of inner block 
System.out.printl n(x) ; 

} 

This example merely demonstrates the syntax of a block; we wouldn’t normally put a block inside another 
block for no reason. Most nested blocks involve declaration statements that create local variables. A simple 
example of a block with declarations is 

{ 

int i = 5 + j; r 

//i is created in this block, j is from elsewhere 

m ■ m 

} //end of block i disappears 

In this example the i nt variable i is created when this block is executed. When this block is started, i is 
placed in memory with its initial value calculated as 5 plus the value of j. When the block is exited, the vari¬ 
able disappears. 

Blocks are not terminated by semicolons. Rather they are terminated by a closing brace, also called the right 
brace. Recall that the semicolon, when used, is part of the statement, not something added to the statement. 
For example, the semicolon turns an expression into a statement. Understanding this will make it much eas¬ 
ier for you to create syntactically correct programs with the new statement types that we introduce in this 
chapter. 


3-1.1 EMPTY STATEMENT 

The simplest statement is the empty statement , or null statement. It is just a semicolon all by itself and 
results in no action. A semicolon placed after a block is an empty statement and is irrelevant to the pro¬ 
gram’s actions. The following code fragment produces exactly the same result as the nested block example in 
the preceding section. The string of semicolons simply create seven empty statements following the inner 
block. 
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x = 1; 

{ 

y = 2; 

System.out.println(y); 

Jm n m 

System.out.println(x); 
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3.2 BOOLEAN EXPRESSIONS 


A boolean expression is any expression that evaluates to either true or false. Java includes a primitive type 
boolean. The two simplest boolean expressions are the boolean literals true and fal se. In addition to these 
two literals, boolean values result from expressions involving either relational operators for comparing num¬ 
bers or logical operators that act on boolean values. 


3-2,1 RELATIONAL AND EQUALITY OPERATORS 

All conditional statements require some boolean expression to decide which execution path to follow. Java 
uses four relational operators : less than, < ; greater than, > ; less than or equal, <= ; and greater than or 
equal, >= . Java also contains two equality operators: equal, == ; and not equal, ! = . They can be used between 
any two numeric values. The equality operators may also be used when comparing nonnumeric types. They 
are listed in the following table. 


Operator 

r \'■ :-v • v.• v;>:;:;:O:;:;X;:;I 

; NAMSlr ff 

Example 

< 

Less than 

10 < 20 is true. 

> 

Greater than 

10 > 2 0 is false. 


Equal 

10 == 20 is false. 

<= 

Less than or equal 

10 <= 10 is true. 

>= 

Greater than or equal 

11 >= 10 is true. 

1 _ 

■ 

Not equal 

10 != 20 is true. 


The relational operators can be used in assignment to boolean variables, as in 

■ E ■ jj 

int i = 3, ] = 4; 
boolean flag; 

flag = 5 < 6; //flag is now true 

flag = (i ===== j); //flag is now false 

flag = (j + 2) <= 6; //flag is now true 


3.2,2 LOGICAL OPERATORS 

Once you have a boolean value, either stored in a variable representing a primitive boolean value (for exam¬ 
ple, bool ean done = fal se ;) or as the result of an expression involving a relational operator (for example, 
(x < y)), you can combine these boolean values by using the logical operators. Java provides three logical 
operators, “and,” “or,” and “not.” The meaning of these operators is given in the following table. 
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Operator 

- 

Name 

Description 

Example—Assume x is 10 and y Is 20 

&& 

and 

The expression x && y is 
true if both x AND y are true 
and false otherwise. 

(x < 20) && (y < 30) is true. 

11 

or 

The expression x | | y is 
true if either x OR y (or both) 
is true and false otherwise. 

(x < 20) || Cy > 30) is true. 

i 

* 

not 

The expression ! x is true if x 
is false and false otherwise. 

! (x < 20) is false. 


For example, if you wanted to determine whether a person in a database was an adult but not a senior citi¬ 
zen, you could check if their age was greater than or equal to 18 and their age was less than 65. The follow¬ 
ing Java code fragment will print out “full fare adult is true” if this condition is met; otherwise, it prints “full 
fare adult is false”. 

boolean b = (ageOfPerson >= 18 && ageOfPerson < 65); 

System.out.println("ful1 fare adult is " + b); 

For an example of the use of “or,” consider the opposite situation as above where you wanted to find out if a 
reduced fair was appropriate. You might write 

b = (ageOfPerson < 18 || ageOfPerson >= 65); 

System.out.println("reduced fare is " + b); 

The logical operators && and | | use short-circuit evaluation. In the preceding example of a logical “and” 
expression, if the ageOfPerson were 10, then the test for ageOfPerson < 65 would be omitted. Used partly 
for efficiency reasons, this approach is helpful when the second part of such an expression could lead to an 
undesirable result, such as program termination. 

As with other operators, the relational, equality, and logical operators have rules of precedence and associa¬ 
tivity that determine precisely how expressions involving these operators are evaluated, as shown in the fol¬ 
lowing table. 


Operator Precedence and Associativity 

; • y XvX-x'x-x:::::::::;!:!::::!.:: 3333:-:: ,,.x . ; :x,: : :xx x :x 

: MH : ^ .... 

iiii* .. 

vrCRn 1 

: :. :>./ • .: ; x..x : : : : :x: ;, : ; x.;: x : x .. , . ,-vx ; :X :*■'< -xx-xX. : • ::x-x:x::xX:X:::x ; , • • • •::::>>> 

X..11x11.. . = . 

Associativity 

■ ■■■: —- — — j 

() ++ (postfix) -- (postfix) 

Left to right 

+ (unary) - (unary) ++ (prefix) -- (prefix) ! 

Right to left 

/ % 

Left to right 

+ 

Left to right 

it 

A 

A 

tl 

V 

V 

Left to right 

ii 

II 

II 

Left to right 


Left to right 

\ \ 

Left to right 

= += -= *= /= etc. 

Right to left 


Note that with the exception of the boolean unary operator negation, the relational, boolean, and equality 
operators have lower precedence than the arithmetic operators. Only the assignment operators have lower 
precedence. 
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3.3 THE if STATEMENT 


Computers make decisions by evaluating expressions and executing different statements based on the value 
of the expression. The simplest type of decision is one that can have only two possible outcomes, such as go 
left versus go right or continue versus stop. In Java, we use boolean expressions to control decisions that have 
two possible outcomes. 

The i f statement is a conditional statement. An i f statement has the general form 

i f ( BooleanExpr ) 

Statement 

If the expression BooleanExpr is true, then the statement, Statement, is executed; otherwise, Statement is 
skipped. Statement is called the then statement. In some programming languages, but not Java, then is used 
to signal the then statement. .After the i f statement has been executed, control passes to the next statement. 
The flow of execution can skip around Statement as shown in the following diagram. 

Execution Enters if Statement 



Continue with rest of program 

Note the absence of semicolons in the general form of the i f statement. Recall that the semicolon, when 
required, is part of the Statement and is not used to separate statements, as in 

if (temperature < 32) 

System.out.printlnC'Warning: Below freezing!"); 

System.out.println("It’s " + temperature + " degrees”); 

The message Warni ng : Below f reezi ng ! is printed only when the temperature is less than 32. The sec¬ 
ond print statement is always executed. This example has a semicolon at the end of the i f statement because 
the statement inside the i f statement is an expression statement that ends with a semicolon. 

When the Statement inside an i f statement is a block, you get i f statements that look like 

if (temperature < 32) 

{ 

System.out.printlnC'Warning Warning Warning!"); 

System.out.printlnC’Warning: Below freezing!"); 

System.out,println("Warning Warning Warning!"); 

} 


Here you can see the importance of the block as a means of grouping statements. In this example, what oth¬ 
erwise would be three separate statements are grouped, and all are executed when the boolean expression is 
true. The formatting shown of the i f statement with a block as the Statement ahgns vertically with the 
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braces of the block statement. An alternative formatting—and the one that we use—places the opening brace 
on the same line as the keyword i f and then aligns the closing brace with the keyword as shown here. 

if (temperature < 32) { 

System.out.println("Warning Warning Warning!"); 

System.out.println("Warning: Below freezing!"); 

System.out.println("Warning Warning Warning!"); 

} 

At the end of this chapter, we discuss further which style to choose. 


33.1 PROBLEM SOLVING WITH THE i f STATEMENT 

A different number is initially placed in each of three boxes, labeled a, b , and c, respectively. The problem is 
to rearrange or sort the numbers so that the final number in box a is less than that in box b and that the 
number in box b is less than that in box c. Initial and final states for a particular set of numbers are as fol¬ 
lows. 



Before 


After 

a 

17 

a 

6 





b 

6 

b 

ii 





c 

11 

c 

17 


Pseudocode for perfor min g this sorting task involves the following steps. 

Pseudocode for three-number sort 

1. Place the first number in box a. 

2. Place the second number in box b. 

3. Place the third number in box c. 

4. If the number in a is not larger than the number in b, go to step 6. 

5. Interchange the number in a with that in b. 

6. If the number in b is larger than the number in c, then go to step 7; 
otherwise, halt. 

7. Interchange the numbers in b and c. 

8. If the number in a is larger than that in b , then go to step 9; otherwise, 
hal t. 

9. Interchange the numbers in a and b. 

10. Halt. 

Let’s execute this pseudocode with the three specific numbers previously given: 17, 6, and 11, in that order. 
We always start with the first instruction. The contents of the three boxes at various stages of execution are 
shown in the following table. 


BOX 

Step 1 

Step 2 

Step 3 

i : : :: '-if:-^ : 

Step 5 

: ircvoT:.:'. rrTT . vX .. 

Step 7 

; L : 

a 

17 

17 

17 

6 

6 

b 


6 

6 

17 

11 

c 



ii 

11 

17 
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To execute step 1, we place the first number, 17, in box a ; similarly, at the end of instruction 3, the 6 has 
been inserted into box b, and box c contains the 11. As 17 is larger than 6, the condition tested in step 4 is 
false, and we proceed to instruction 5; this step switches the values into boxes a and b so that box a now con¬ 
tains the 6 and box b has the 17. Step 6 has now been reached, and we compare the number in box b (17) to 
that in box c (11); 17 is greater than 11, so a transfer is made to step 7. The numbers in boxes b and c are 
then interchanged so that box b has the 11 and box c has the 17. The test in step 8 fails (6 is not larger than 
11) and the computation then halts. The three numbers have been sorted in ascending sequence (i.e., 6 < 11 < 
17). You should convince yourself by bench testing this algorithm with other values of a, b , and c that the 
computation described by the pseudocode will work correctly for any three numbers. A flowchart of the sort¬ 
ing algorithm is shown in the following diagram. 



Note that we decomposed the operation of interchanging two numbers into three more primitive instruc¬ 
tions. Box t is used as temporary 7 storage to hold intermediate results. In order to interchange or switch the 
two numbers a and b, we first temporarily store one of the numbers, say, a, in t (t <- a)\ next the other num¬ 
ber is stored in a (a <- b ), and, last, the first number is placed in b (b <- f). Note that the instruction sequence 
11 a <— b ; b <— a” will not interchange a and b because the first instruction effectively destroys the old value in 
a. In computer terms, the labeled boxes are analogous to memory or storage areas that can contain values. 

Next we code in Java the pseudocode version of our sorting program. 

// Sortlnput.java - sort three numbers 
import java.util.*; 

class Sortlnput { 

public static void main (String[] args) { 
int a, b, c, t; 

Scanner scan = new Scanner(System.in); 

System.out.println("type three integers:"); 
a = scan.nextlntO ; 
b = scan.nextlnt(); 
c = scan.nextlnt(); 
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if (a > b) { 
t = a; 
a = b; 
b = t; 

} 

if (b > c) { 
t = b; 
b = c; 
c = t; 

} 

if (a > b) { 
t = a; 
a = b; 
b = t; 

} 

System.out.printC’The sorted order is : "); 

System.out.println(a + " , " + b + ”, " + c); 

} 

} ' 




Dissection of the Sortlnput Program 

• int a, b, c, t; 

This program declares four integer variables. The variables a, b, and c are inputs to be sorted, and t is to 
be used for temporary purposes, as described in the pseudocode. 

# System.out.println( n type three integers:"); 

This line is used to prompt the user to type the three numbers to be sorted. Whenever a program is 
expecting the user to do something, it should print out a prompt telling the user what to do. 

# a = scan.nextlntQ; 

b = scan. nextlntO ; 
c = scan.nextlntO ; 

The method call expression scan. nextlntO is used to obtain the input from the keyboard. Three sepa¬ 
rate integers need to be typed. The values read will be stored in the three variables, 

• if (a > b) { 

t = a; 
a = b; 
b = t; 

} 

if (b > c) { 
t = b; 
b = c; 
c = t; 

} 

if (a > b) { 
t - a; 
a = b; 
b = t; 

} 

The i f statements and resulting assignments are Java notation for the same actions described in the 
sort flow chart. To comprehend these actions you need to understand why the interchange or swapping 
of values between two variables, such as a and b, requires the use of the temporary t. Also note how the 
three assi gnm ents are grouped as a block, allowing each i f expression to control a group of actions. 
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System.out.printC'The sorted order is : "); 
System.out.printlnCa + ", " + b + ", " + c); 


If the input values were 10, 5, and 15, the output would be 





3.1 THE if-else STATEMENT 


Closely related to the i f statement is the i f-el se statement. An i f-el se statement has the following gen¬ 
eral form: 

if ( BooleanExpr ) Statement1 else Statement2 

If the expression BooleanExpr is true, then Statementl is executed and Statement2 is skipped; if BooleanExpr 
is false, then Statementl is skipped and Statement2 is executed. Statement2 is called the el se statement. 
After the i f-el se statement has been executed, control passes to the next statement. The flow of execution 
branches and then rejoins, as shown in the following diagram. 

Execution enters if-else statement 



Continue with rest of program 


Consider the following code: 

if (x < y) 
min = x; 
else 

min = y; 

System.out.println("min = " + min); 

If x < y is true, then mi n will be assigned the value of x; if it is false, then mi n will be assigned the value of y. 
After the i f-el se statement is executed, mi n is printed. 
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As with the i f statement, either branch of anif-else statement can contain a block, as shown in the follow¬ 
ing example. 

if (temperature < 32) { 

System.out.println("Warning Warning Warning!"); 

System.out.println(32 - temperature + " degrees below freezing!"); 

System.out.println(”Warning Warning Warning!"); 

} 

el se { 

System.out.println("It’s " + temperature + "degrees fahrenheit."); 


Common Programming Error 

A semicolon is used to change an expression to an expression statement. All statements do not end in 
semicolons, and extraneous semicolons can cause subtle errors. Look carefully at the following code 
fragment. What is printed when it executes if x is 3 and y is 4? 

if (x < y); 

System.out.println("The smaller is " + x); 
if (y < x); 

System.out.println("The smaller is " + y); 

The answer is 

The smaller is 3 
The smaller is 4 

Note the extra semicolon after the close parenthesis in each i f statement. The indentation is misleading: 
All four lines should be indented the same to reflect what is actually going to happen. The true branch of 
each i f statement is the empty statement “; ”, The example code is syntactically correct but semantically 
incorrect. 


Comon Programming Error 

Another co mm on error is to be misled by indentation and to try to include two statements in one branch 
without using a block. Consider this example. 

if (temperature < 32) 

System.out.print("It is now"); 

System.out.print(32 - temperature); 

System.out.println(" below freezing."); 

System.out.println("It's " + temperature + "degrees"); 

A user might mistakenly t hink that, if temperature is 32 or above, the code will execute only the last 
print statement displaying temperature. That is almost certainly what was intended. Unfortunately, if 
temperature is 32 or above, only the first pri nt () would be skipped. 

If temperature is 45 the following confusing message would be printed: 

-13 below freezing. 

It's 45 degrees 
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To get the behavior suggested by the indentation shown, a block must be used, as in 

if (temperature < 32) { 

System.out.print("It is now"); 

System.out.print(32 - temperature); 

System.out.println(" below freezing."); 

} 

System.out.println("It's " + temperature + "degrees"); 


.1 NESTED if-el se STATEMENTS 

The i f statement is a full-fledged statement and can be used anywhere a statement is expected, 
so you could put another i f statement in either branch of an i f statement. For example, you 
could rewrite the earlier air fare checking statement as 

if (ageOfPerson >= 18) 
if (ageOfPerson < 65) 

System.out.println("full fare adult"); 

If the expression (ageOf Per son >= 18) is true, then the statement 

if (ageOfPerson < 65) 

System.out.print!n("full fare adult"); 

is evaluated. The true branch for the ageOf Person >- 18 i f statement is itself an i f statement. In general, 
if the true branch of an i f statement contains only another i f statement, writing it as a single i f statement 
is more efficient, combining the expressions with the operator &&, as we did in Section 3.2.2, Logical opera¬ 
tors , on page 49. Using && in most cases is also clearer. 

These nested i f statements can’t always be collapsed. Consider the following variation on our earlier exam¬ 
ple involving temperature. 

r 

if (temperature < 32) { 

System.out.println("Warning Warning Warning!"); 
if (temperature < 0) 

System.out.println((-temperature) + " degrees below Zero!" 
else 

System.out.println(32 - temperature + "(F) below Freezing!"); 

System.out.println("Warning Warning Warning!"); 

} 

else { 

System.out.printlnC'Tt is " + temperature + " degrees fahrenheit."); 

} 

The then statement for the outer i f-el se statement is a block containing another i f-el se statement. 
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Common Programming Error 

In algebra class you came across expressions such as 18 < age < 65. This expression tempts many new 
programmers to write 

if (18 <= age < 65) ... 

In evaluating the expression, Java first evaluates (18 , <= age)—let’s call it parti—which is either true 
or false. It then tries to evaluate (parti < 65), which is an error because relational operators are used 
to compare two numbers, not a boolean and a number. The only good thing about this type of mistake is 
that the compiler will catch it. Our example earlier for printing full fare adul t showed the proper 
way to handle this situation. 


3.1.2 i f-el se-i f-el se-i f ... 

In the preceding example, the nesting was all done in the then statement part of the i f-el se statement. 
Now we nest in the else statement part of the i f-el se statement: 

if (ageOfPerson < 18) 

System.out.printIn ("chi Id fare"); 
el se { 

if (ageOfPerson < 65) 

System.out.println("adult fare"); 
el se 

System.out.println("senior fare"); 

} 

The braces are not needed; we added them only for clarity. This form is so common that experienced pro¬ 
grammers usually drop the braces. In addition, the else and the following i f are usually placed on the same 
line, as in 

if (ageOfPerson < 18) 

System.out.println("chiId fare"); 
else if (ageOfPerson < 65) 

System.out.println("adult fare"); 
el se 

System.out.println("senior fare"); 

Note that the second i f statement is a single statement that constitutes the else branch of the first state¬ 
ment. The two forms presented are equivalent. You should be sure that you understand why they are. If you 
need to, look back at the general form of the i f statement and recall that an entire i f-el se statement is a 
statement itself. This fact is illustrated in the following figure, wherein each statement is surrounded by a 
box. As you can see, there are five different statements. 
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if (ageOfPerson < 18) 



System.out.println("child fare"); 

el se 

if (ageOfPerson < 65) 


System.out.println("adult fare"); 

el se 


System.out.println("senior fare"); 


Sometimes this chain of i f-el se~i f-el se-i f-el se... can get rather long, tedious, and inefficient. For this 
reason, a special construct can be used to deal with this situation when the condition being tested is of the 
right form. If you want to do different things based on distinct values of a single integer expression, then you 
can use the swi tch statement, which we discuss in Section 3.4, The switch statement , on page 69. 


13 THE DANGLING el se PROBLEM 

When you use sequences of nested i f-el se statements, a potential problem can arise as to what i f an el se 
goes with, as for example in 

if ( Expression 1) 
if ( Expression ) 

Statementl 

el se 

Statement2 

The indenting suggests that Statement2 is executed whenever Expressionl is false; however, that isn’t the 
case. Rather, Statement2 is executed only when Expressionl is true and Expression2 is false. The proper 
indenting is 

if ( Expressionl ) 
if ( Expression2 ) 

Statementl 

else 

Statement2 

The rule used in Java is that an el se is always matched with the nearest preceding i f that doesn’t have an 
el se. To cause Statement2 to be executed whenever Expressionl is false, as suggested by the first indenting 
example, you can use braces to group the statements as shown. 

if ( Expressionl ) { 
if ( Expression ) 

Statementl 

} 

el se 

Statement2 

The braces are like parentheses in arithmetic expressions that are used to override the normal precedence 

rules. The nested, or inner, i f statement is now inside a block that prevents it from being matched with the 
el se. 
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3.2 THE while STATEMENT 


We have added the ability to choose among alternatives, but our programs still execute each instruction at 
most once and progress from the top to the bottom. The while statement allows us to write programs that 
run repeatedly. 

The general form of a whi 1 e statement in Java is 

while ( BooleanExpr ) 

Statement 

Statement is executed repeatedly as long as the expression BooleanExpr is true, as shown in the following 
flowchart. 


Execution enters while statement 



Continue with rest of program 


This flowchart is the same as the one for the i f statement, with the addition of an arrow returning to the test 
box. 

Note that Statement may not be executed. That will occur when BooleanExpr evaluates to false the f irst time. 
Note also, that like the description of the i f-el se statement, there are no semicolons in the general form of 
the while statement. The semicolon, if any, would be part of the statement that follows the parenthesized 
boolean expression. 

A simple example for use on Valentine’s Day is 

// Valentine.java - a simple while loop 
class Valentine { 

public static void main(String[] args) { 
int howMuch --0; 
while (howMuch++ < 5) 

System.out.println("I love you."); 

} 

} 


The output is 
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I love you. 
I love you. 
I love you. 
I love you. 
I love you. 


When the body of the loop is a block you get 

while ( BooleanExpr ) { 

Statement1 
Statement2 


} 

Modifying our earlier example gives 

int howMuch = 0; 
while (howMuch++ < 5) { 

System.out.print(”I love you."); 

System.out.println {" @->- my rose."); 

} 

which results in the output 


I 

love 

you. 

@->_ my 

rose. 

I 

love 

you. 

@->- my 

rose. 

I 

love 

you. 

@->- my 

rose. 

I 

love 

you. 

@->- my 

rose. 

I 

love 

you. 

@->- my 

rose. 


Most whi le statements are preceded by some initialization statements. Our example initialized the loop 
counting variable howMuch. 


.1 PROBLEM SOLVING WITH LOOPS 

Suppose that you wanted to have a program that could read in an arbitrary number of nonzero values and 
compute the average. If you were to use pseudocode, the program might look like the following. 

Pseudocode for average, using goto 

1. Get a number. 

2. If the number is 0 go to step 6. 

3. Add the number to the running total. 

4. Increment the count of numbers read in. 

5. Go back to step 1. 

6. Divide the running total by the count of numbers in order to get the average. 

7. Print the average. 

In this pseudocode, step 5 goes back to the beginning of the instruction sequence, forming a loop. In the 
1950s and 1960s many programming languages used a goto statement to implement step 5 for coding such a 
loop. These goto statements resulted in programs that were hard to follow because they could jump all over 
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the place. Their use was sometimes called spaghetti code. In Java there is no goto statement. Java includes 
goto as a keyword that has no use so that the compiler can issue an error message if it is used inadvertently 
by a programmer f amili ar with C or C++. Today structured control constructs can do all the good things but 
none of the bad things that you could do with goto statements. 

A loop is a sequence of statements that are to be repeated, possibly many times. The preceding pseudocode 
has a loop that begins at step 1 and ends at step 5. Modem programs require that you use a construct to indi¬ 
cate explicitly the begi nnin g and the end of the loop. The structured equivalent, still in pseudocode, might 
look like the following. 

Pseudocode with Loop 

Pseudocode for average, without using goto 
get a number 

while the number is not 0 do the following: 
add the number to the running total 
increment the count of numbers read in 
get a number 
(when the loop exits) 

divide the running total by the count of numbers to get the average 
print the average 

The loop initialization in this case is reading in the first number. Somewhere within a loop, typically at the 
end, is something that prepares the next iteration of the loop-getting a new number in our example. So, 
although not part of the required syntax, whi 1 e statements generally look like the following 

Statement^ // initialization for the loop 

while ( BooleanExpr ) { 

Statementl 

Statement2 

m ■ * 

Statement nex( // prepare for next iteration 

} 

The whi 1 e statement is most often used when the number of iterations isn’t known in advance. This situa¬ 
tion might occur if the program was supposed to read in values, processing them in some way until a special 
value called a sentinel was read in. Such is the case for our “compute the average” program: It reads in num¬ 
bers until the sentinel value 0 is read in. 

We can now directly translate into Java the pseudocode for computing an average. 

// Average.java - compute average of input values 
import java.util.*; 
public class Average { 

public static void main(String[] args) { 
double number; 
int count = 0; 
double runningTotal = 0; 

Scanner scan = new Scanner(System.in); 

// initialization before first loop iteration 

System.out.println("Type some numbers, the last one being 0”); 

number = scan.nextDouble(); 

while (number != 0) { 

runningTotal = runningTotal + number; 
count = count + 1; 

// prepare for next iteration 
number = scan.nextDoubleQ ; 


} 
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System.out.print("The average of the ”); 

System.out.print(count); 

System.out.print(" numbers is "); 

System.out.println(runningTotal / count); 

} 

} 




Dissection of the Average Program 


# double number; 
int count =0; 

double runningTotal 0; 

The variable number is used to hold the floating point value typed in by the user. No initial value is given 
in the declaration because it gets its initial value from user input. The variable count is used to count 
the number of nonzero values read in. Counting is done efficiently and accurately with whole numbers, 
so the variable count is an i nt initialized to zero. The variable runni ngTotal is used to accumulate the 
sum of the numbers read in so far and is initialized to zero. Similar to assignment statements, these are 
declaration statements with initial values. Later we show when declaration statements can be used but 
assignment statements can’t. 

• System.out.println("Type some numbers, the last one being 0”); 
number = scan.nextDoubleQ; 


A message should always be printed to prompt the user when the user is expected to enter data. We 
could have initialized number when it was declared, but it is central to the loop so we initialized it just 
before entering the loop. These two statements correspond to the first line of our pseudocode. All the 
preceding code is supporting syntax required by Java. 

# while (number != 0) { 

The loop will continue while the value stored in the variable number is not 0. The value 0 is used to 
detect the end of the loop. It acts as a sentinel to keep the loop from r unnin g forever. A sentinel is an 
important technique for ter min ating loops correctly. 

H runningTotal = runningTotal + number; 
count = count + 1; 
number = scan.nextDouble(); 

} 

The first statement in the loop body would look strange in a mathematics class unless number was 0. 
Recall that the symbol = is not an equals sign; it is the assignment operator. It means: Evaluate the 
expression on the right and then assign that value to the variable on the left. The result in this case is to 
add the value of number to the value of runni ngTotal and store the result in runni ngTotal . This type 
of expression is common in computer programs: It computes a new value for a variable, using an expres¬ 
sion that includes the old value of the variable. Similarly, we increment the value of count. The last 
statement in the body of the loop gets ready for the next iteration by reading in a new value from the 
user and storing it in number . This action overwrites the old value, which is no longer needed. At thi s 
point the computer will go back and evaluate the boolean expression to determine whether the loop 
should execute again (i.e., number isn’t 0) or continue with the rest of the program. 

• System.out.println(runningTotal / count); 

When the user finally types a 0, the program prints the answer and exits. We have already used the 
printQ and pri ntl n() methods with a string and with a number. Here we show that the number can 
be an expression. Recall that the symbol / is the symbol for division. If the first number typed is 0, this 
program will terminate by printing 
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The average of the 0 numbers is NaN 


The symbol NaN stands for not a number and results from dividing zero by zero. A better solution might 
be to test, using an i f-el se statement, for this special case and print a more appropriate message. We 
leave that for you to do as an exercise. 



Common Programming Error 

Every progr amm er has probably forgotten the “prepare for next iteration” line at least once, causing a 
program to loop forever. W hen coding a whi 1 e statement, be careful to verify that some variable changes 
each time around the loop. Also check to be sure that the loop condition will eventually be reached. How 
many times will the following loop execute? 

int count =13; 

System.out.printlnCThe multiples of 13 between 1 and 100 are:"); 
while (count != 100){ 

System.out.println(count); 
count = count +13; 

} 

The loop will run forever because count will never equal 100. The problem is obvious in this small exam¬ 
ple, and such problems do occur—although they’re not always so apparent. A test for less than or 
greater than is always preferable to a test of strict equality or inequality. 



3.1 THE DO STATEMENT 


A variant of the while statement is the do statement. The general form of a do statement in Java is 
do 

Statement 

while ( BooleanExpr ) 

Here the test for exiting is syntactically and semantically made at the end of executing each iteration of State¬ 
ment. This means that Statement is executed at least once. Execution stops when the expression BooleanExpr 
is false, 
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An example using this construct is a loop for computing the greatest common divisor for two integers using 
Euclid’s algorithm. 

import java.util.*; 


class CreatestCommonDivisor{ 

public static void main(Strirtg[] args) 

{ 

Scanner scan = new Scanner(System.in) 

System.out.println( M Enter 2 integers. 

int numl = scan.nextlnt(); 

int num2 = scan. nextlntO ; 

int m = numl, n = num2, remainder; 

do { 

remainder = m % n; 
m = n; 

n = remainder; 

} while( n 1=0); 

System.out.println("GCD (" + numl + 

") = " + m ); 

} 

} 




if 


+ num2 + 


You should carry out this computation by hand to make sure you understand the do-statement and its use in 
this oldest of algorithms. 



3.2 THE FOR STATEMENT 


You can use the while construct to create any loop you will ever need. However, Java, like most modem pro¬ 
gramming languages, provides two alternative ways to write loops that are sometimes more convenient. The 
do statement discussed in the previous section is one alternative. The other alternative is the for statement. 
The for statement is a looping statement that captures the initialization, termination test, and iteration prep¬ 
aration all in one place at the top of the loop. The general form of the for statement is 

for ( Forlnit ; BooleanExpr ; UpdateExpr') 

Statement 

As part of the syntax of the for statement, the semicolons are used to separate the three expressions. Note 
the absence of a semicolon between UpdateExpr and the closing parenthesis. 

The following steps occur in the execution of a for statement. 

1. Forlnit is evaluated once—before the body of the loop. 

2. BooleanExpr is tested before each iteration and, if true, the loop continues (as in the whi 1 e state¬ 
ment). 

3. The loop body Statement is executed. 

4. UpdateExpr is evaluated at the end of each iteration . 

5. Go to step 2. 

The following diagram also shows the flow of execution. 
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Execution enters for statement 



Continue with rest of the program 


Compare this general form and the flow with that of the whi 1 e statement. In the for statement, the initial¬ 
ization expression represented by Forlnit and the iteration expression represented by UpdateExpr frequently 
involve the use of an assignment operator, but one is not required. 

The for statement applies most naturally to situations involving going around a loop a specific number of 
times. For example, if you wanted to print out the square roots of the numbers 1 through 10 you could do so 
as follows. 


// SquareRoots.java - print square roots of 1 - 10 
import static java.lang.Math.*; 
public class SquareRoots { 

public static void main(String[] args) { 
i nt i ; 

double squareRoot; 
for (i = 1; i <=10; i+-i-) { 
squareRoot = sqrt(i); 

System.out.println("the square root of " + i + " is " + squareRoot); 

} 

System.out.println("That' s All!"); 

} 

} 




Dissection of the SquareRoots Program 

IP import static java.lang.Math.*; 

A i mpo rt stati c can be used to import the static fields and methods from a class for use without qual¬ 
ification in the local context. Here it is used to allow us to call j ava .lang. Math. sq rt () by simply writ¬ 
ing sqrtQ. 

H for (i - 1; i <=10; i++) { 

The expression i = 1 is evaluated only onee—before the loop body is entered. The expression i <= 10 
is evaluated before each execution of the loop body. The expression i ++ is evaluated at the end of each 
loop body evaluation. Recall that i ++ is shorthand for i = i + 1. 
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• squareRoot = sqrt(i); 

System.out.printlnC’the square root of " + i + " is " + squareRoot); 

} 

The body of the loop is one statement—in this case a block. The braces are part of the block syntax, not 
part of the syntax of a for statement. 

# System.out.println("That's All!”); 

When the loop exits, program execution continues with this statement. 



We can redo the square root printing loop by using a whi 1 e statement as follows. 

// SquareRoots2.java - replace for with while 
public class SquareRoots2 { 

public static void main(String[] args) { 
i nt i; 

double squareRoot; 

i = 1; // initialization-expr 

while (i <= 10) { 

squareRoot = Math.sqrt(i); 

System.out.printlnC’the square root of " + i + " is " + squareRoot); 
i ++; // iteration-expr 

} 

System.out.println("That's All!"); 

} 

} 

In both versions of this program, the same sequence of steps occurs. 

1. The variable i is initialized to 1. 

2. The boolean expression i <= 10 is tested, and if true, the loop body is executed. If the expres¬ 
sion is false, the loop statement is completed and execution continues with the next statement in 
the program, the final print statement. 

3. After executing the print statement within the loop, the statement incrementing the variable i is 
executed, in preparation for the next loop iteration. 

4. Execution continues with step 2. 


2.1 LOCAL VARIABLES IN THE for STATEMENT 

The Forlnit part of the for statement can be a local declaration. For example, let’s rewrite the above for-loop. 

for (int i = 1; i <= 10; i++) { 
squareRoot = sqrt(i); 

System. out. println("the square root of " + i + " is " + squareRoot); 

} 

In this case, the i nt variable i declared in the for statement is limited to the for statement, including the 
body of the loop. The variable’s existence is tied to the for statement code; outside the for statement it dis¬ 
appears. If you want the variable i to exist independently of the for statement you must declare it before the 
for statement. It then is available throughout the block cont aining the for statement. The variable is said to 
have local scope . We discuss scope further in Section 4.4, Scope of Variables, on page 86. 
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3.3 THE break AND continue STATEMENTS 


Two special statements, 

break; and continue; 

interrupt the normal flow of control. The break statement causes an exit from the innermost enclosing loop. 
The break statement also causes a swi tch statement to ter min ate. (We discuss the swi tch statement in Sec¬ 
tion 3.4, The switch statement , on page 69.) In the following example, a test for a negative argument is made. 
If the test is true, then a break statement is used to pass control to the statement immediately following the 
loop. 


while (true) { //seemingly an infinite loop 

System("Enter a positive integer:") 
n = scan.nextlnt(); 
if (n < 0) 

break; // exit loop if n is negative 

System.out.print("squareroot of ” + n); 

System.out.println(" = " + Math.sqrt(n)); 

} 

// break jumps here 


This use of the break statement is typical. What would otherwise be an infinite loop is made to terminate 
upon a given condition tested by the i f expression. 


The conti nue statement causes the current iteration of a loop to stop and causes the next iteration of the 
loop to begin immediately. The following code adds conti nue to the preceding program fragment in order to 
skip processing of negative values. 


// BreakContinue.java - example of break and continue 
import java.util 
class BreakContinue { 

public static void main(String[] args) { 
i nt n; 

Scanner scan = new Scanner(System.in); 
while (true) { //seemingly an infinite loop 

System.out.print("Enter a positive integer "); 
System.out.print("or 0 to exit:"); 
n = scan.nextlnt(); 

if (n == 0) 

break; // exit loop if n is 0 

if (n < 0) 

continue; //wrong value 

System.out.print("squareroot of " + n); 

System.out.println(" = " + Math.sqrt(n)); 
//continue lands here at end of current iteration 

} 

//break lands here 

System.out.println("a zero was entered"); 


} 
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The output of this program, ass umin g that the user enters the values 4, 2 1,9, and 0, is 


os-prompt>java BreakContinue 

Enter a positive integer or 0 to exit:4 

squareroot of 4 = 2.0 

Enter a positive integer or 0 to exit:-l 

Enter a positive integer or 0 to exit:9 

squareroot of 9 = 3.0 

Enter a positive integer or 0 to exit:0 

a zero was entered 

os-prompt> 


The conti nue statement may only occur inside for, whi 1 e, and do loops. As the example shows, conti nue 
transfers control to the end of the current iteration, whereas break ter min ates the loop. 


The break and conti nue statements can be viewed as a restricted form of a goto statement. The break is 
used to go to the statement following the loop and the conti nue is used to go to the end of the current iter¬ 


ation. For this reason, many programmers think that break and conti nue should be avoided. In fact, many 
uses of break and conti nue can be eliminated by using the other structured control constructs. For exam¬ 
ple, we can redo the BreakConti nue example, but without break and conti nue, as follows. 


// NoBreakContinue.java - avoiding break and continue 
import java.util.*; 
class NoBreakContinue { 

public static void main(String[] args) { 
i nt n; 

Scanner scan = new Scanner(System.in); 

System.out.print("Enter a positive integer "); 
System.out.print("or 0 to exit:”); 
n = scan.nextlntQ ; 
while (n != 0) { 
if (n > 0) { 

System.out.print("squareroot of " + n); 
System.out.println(" = " + Math.sqrt(n)); 

} 

System.out.print("Enter a positive integer "); 
System.out.print("or 0 to exit:"); 
n = scan. nextlntO ; 

} 


System.out.println("a zero was entered"); 

} 

} 


The loop termination condition is now exphcitly stated in the whi 1 e statement and not buried somewhere 
inside the loop. However, we did have to repeat the prompt and the input statement—once before the loop 
and once inside the loop. We eliminated conti nue by changing the i f statement to test for when the square 
root could be computed instead of testing for when it could not be computed. 
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3.4 THE switch STATEMENT 


The swi tch statement can be used in place of a long chain of i f ■ -el se-i f-el se~i f-el se statements when 
the condition being tested evaluates to an integer numeric type. Suppose that we have an integer variable 
dayOfWeek that is supposed to have a value of 1 through 7 to represent the current day of the week. We 
could then print out the day as 
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if (dayOfWeek == 1) 

System.out.println("Sunday”); 
else if (dayOfWeek == 2) 

System.out.println("Monday"); 
else if (dayOfWeek == 3) 

System.out.println("Tuesday"); 
else if (dayOfWeek == 4) 

System.out.println("Wednesday"); 
else if (dayOfWeek == 5) 

System.out.println("Thursday"); 
else if (dayOfWeek == 6) 

System.out.println("Friday"); 
else if (dayOfWeek — 7) 

System.out.println("Saturday"); 
el se 

System.out.println("Not a day number " + dayOfWeek); 

An alternative is to use a swi tch statement as follows. 

switch (dayOfWeek) { 
case 1: 

System.out.println("Sunday"); 
break; 
case 2: 

System.out.println("Monday"); 
break; 
case 3: 

System.out.println("Tuesday"); 
break; 
case 4: 

System.out.println("Wednesday"); 
break; 
case 5: 

System.out.println("Thursday"); 
break; 
case 6: 

System.out.println("Friday"); 
break; 
case 7: 

System.out.println("Saturday"); 
break; 
default: 

System.out.println("Not a day number " + dayOfWeek); 

} 

Unlike the i f-el se and looping statements described earlier in this chapter, the braces are part of the syn¬ 
tax of the swi tch statement. The controlling expression in parentheses following the keyword switch must 
be of integral type. Here it is the i nt variable dayOfWeek. After the expression has been evaluated, control 
jumps to the appropriate case label. All the constant integral expressions following the case labels must be 
unique. Typically, the last statement before the next case or def aul t label is a break statement. If there is 
no break statement, then execution “falls through” to the next statement in the succeeding case. Missing 
break statements are a frequent cause of error in swi tch statements. For example, if the break; was left out 
of just case 1 and if dayOfWeek was 1, the output would be 


Sunday 


Monday 



instead of just 
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Sunday 


There may be at most one def aul t label in a swi tch statement. Typically, it occurs last, although it can 
occur anywhere. The keywords case and default can’t occur outside a switch. 

Taking advantage of the behavior when break; is not used, you can combine several cases as shown in the 
following example. 

switch (dayOfWeek) { 
case 1: 
case 7: 

System.out.println("Stay home today!"); 
break; 
case 2: 
case 3: 
case 4: 
case 5: 

.case 6: 

System.out.println("Go to work."); 
break; 
default: 

println("Not a day number " + dayOfWeek); 
break; 


Note that the break statement—not anything related to the case labels—causes execution to continue after 
the swi tch statement. The swi tch statement is a structured goto statement. It allows you to go to one of 
several labeled statements. It is then combined with the break statement, which does another goto, in this 
case “go to the statement after the swi tch.” 

The effect of a switch Statement 

1. Evaluate the switch expression. 

2. Go to the case label having a constant value that matches the value of the expression found in 
step 1; or, if a match is not found, go to the defaul t label; or, if there is no default label, termi¬ 
nate swi tch. 

3. Continue executing statements in order until the end of swi tch is reached or a break is encoun¬ 
tered. 

4. Terminate swi tch when a break statement is encountered, or te rmin ate swi tch by “f allin g off 
the end. ” 



3.5 USING THE LAWS OF BOOLEAN ALGEBRA 


Boolean expressions can frequently be simplified or more efficiently evaluated by converting them to logi¬ 
cally equivalent expressions. Several rules of Boolean algebra are useful for rewriting boolean expressions. 

1. Commutative law: a or b == b or a and a and b ==b and a. 

2. Distributive and law: a and (b or c) == (a and b) or (a and c). 

3. Distributive or law: a or (b and c) = (a or b) and (a or c). 

4. Double negation: !!a == a. 

5. DeMorgan’s laws: !(a or b) == (la and !b) and !(a and b) == la or lb. 
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In the expression x U y, y will not be evaluated if x is true. The value of y in that case doesn’t matter. For 
this reason, it may be more efficient to have the first argument of a boolean or expression be the one that 
most often evaluates to true. This is the basis for short-circuit evaluation of the logical or operator. 


while (a < b 


a — 200) { 


} 

while (a == 200 


a < b) { 


} 


For the two controlling expressions, which order is more likely to be efficient? Note that by the commutative 
law both while conditions are equivalent. 



3.6 PROGRAMMING STYLE 


We follow Java professional style throughout the programming examples. Statements should readily display 
the flow of control of the program and be easy to read and follow. Only one statement should appear on a 
line. Indentation should be used consistently to set off the flow of control. After a left brace, the next line 
should be indented, showing that it is part of that compound statement. There are two conventional brace 
styles in Java. The style we follow in this book is derived from the C and C++ professional programming com¬ 
munity. In this style, an ope nin g or left brace stays on the same line as the beginning of a selection or itera¬ 
tion statement. The closing or right brace lines up under the keyword that starts the overall statement. For 
example, 

if (x > y) { 

System.out.print1n( M x is larger " + x); 
max = x; 

} 

while (i < 10) { » 
sum = sum + i; 
i ++; 

} 

An alternative acceptable style derives from the Algol60 and Pascal communities. In this style each brace is 
kept on a separate line. In those languages the keywords begi n and end were used to set off compound 
statements and they were placed on their own lines. For example, 

if ( x > y) 

{ 

System.out.println("x is larger " + x); 
max = x; 

} 

However, be consistent and use the same style as others in your class, group, or company. A style should be 
universal within a given community. A single style simplifies exchanging, maintaining, and using each others’ 
code. 



Summary 

An expression followed by a semicolon is an expression statement. Expression statements are the most 
co mm on form of statement in a program. The simplest statement is the empty statement, which syntac¬ 
tically is just a semicolon. 
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A group of statements enclosed by braces is a block. A block can be used anywhere a statement can be 
used. Blocks are important when you need to control several actions with the same condition. This is 
often the case for selection or iteration statements such as the i f-el se statement or the for statement, 
respectively. 

All statements don’t end with a semicolon. The only statements covered in this chapter that end with a 
semicolon are expression statements and declaration statements. 

The general form of an i f statement is 

if ( BooleanExpr ) 

Statement 

The general form of an i f-el se statement is 



if ( BooleanExpr ) 
Statement 1 
el se 

Statement2 


• When nesting an if statement inside an if-else statement or vice-versa, the else will always be 
matched with the closest unmatched i f . This precedence can be overridden with a block statement to 
enclose a nested if statement or if-else statement. 

# The general form of the while statement is 


while ( BooleanExpr ) 

Statement 

The general form of the for statement is 

for ( Forlnit ; BooleanExpr ; UpdateExpr ) 
Statement 


• Java includes the usual logical operators and , or, and not. 

• The break statement can be used to terminate abruptly the execution of either a swi tch statement or a 
looping statement. When a break is executed inside any of those statements, the enclosing swi tch or 
loop statement is immediately terminated and execution continues with the statement following the 
switch or loop. 

• The continue statement is used only inside a looping statement. When a continue is executed, the 
remaining portion of the surrounding loop body is skipped and the next iteration of the loop is begun. In 
the case of the while statement, the loop termination expression is tested as the next operation to be 
performed after the continue. In the case of the for statement, the update expression is evaluated as the 
next operation, followed by the loop termination test. 

• The swi tch statement is an alternative to a sequence of i f-el se-i f-el se ... statements. The swi tch 
statement can be used only when the selection is based on an integer-valued expression. 



Review Questions 


1. True or false? An expression is a statement. 

2. How do you turn an expression into a statement? 

3. True or false? All statements end with a semicolon. If false, give an example to show why. 




/ 
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4. True or false? An i f statement Is always ter min ated with a semicolon. If false, give an example to show 
why. 

5. What are the values of the following Java expressions? 

true && false 
true || false 

6. Write a Java expression that is true whenever the variable x is evenly divisible by both 3 and 5. Recall that 
(x % y) is zero if y evenly divides x. 

7. What is printed by the following program fragment? 

x = 10; 

y = 20; 

if ( x < y) 

System.out.println("then statement executed"); 
el se 

System.out.println("else statement executed"); 

System.out.println("when is this executed?"); 

8. What is printed by the following program, if 3 and 12 are entered as x and y? Now if you change the 
order and enter 12 and 3, what is printed? 

//PrintMin.java ~ print the smaller of two numbers 
import java.util.*; 
class PrintMin { 

public static void main(String[] args) { 

Scanner scan = new Scanner(System.in); 

System.out.println("Type two integers."); 
int x = scan.nextlntC); 
int y = scan.nextlntC); 

if (x < y) 

System.out.println("The smaller is " + x); 
if (y < x) 

System.out.println("The smaller is " + y); 
if (x == y) 

System.out.println("They are equal,"); 

} 

} 

9. For the declarations shown, fill in the value of the expression or enter *i 11 egal *. 
int a = 2, b = 5, c = 0, d = 3; 


Expression 

t-: - • • : • - ' : : ..; : . v: : : : :: : : 

Value 

Xr 11 •• : w . 

b % a 


a < d 


(c != b) && (a > 3) 


a / b > c 


a * b > 2 



10. What is printed by the following program fragment? How should it be indented to reflect what is really 
going on? 
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x = 10; 

y = 20; 

z = 5; 
if ( x < y) 
if ( x < z) 

System.out.println( n statementl n ); 
else 

System.out.println("statement2"); 

System, out. pri ntl rt( M statement3") ; 

1 I. How many times will the following loop print testing? 

int i =10; 
while (i > 0) { 

System.out.println( M testing"); 


12. How many times will the following loop print testing? 

int i — 1; 
while (i != 10) { 

System.out.println("testing"); 
i = i + 2; 

} 

13. What is printed by the following loop? See Question 6, on page 74. 

int i = 1; 
while (i <= 100) { 
if (i % 13 == 0) 

System.out.println(i); 
i = i + 1; 

} 

14. Rewrite the loop in the previous question using a for statement. 

15. Rewrite the following loop, using a whi 1 e statement. 

for (i =0; i < 100; i++) { 
sum = sum + i; 

} 

16. True or false? Anything that you can do with a whi 1 e statement can also be done with a for statement 
and vice-versa. 

17. How many times will the following loop go around? This is a trick question—look at the code fragment 
carefully. It is an example of a co mm on programming error. 

int i =0; 
while (i < 100) { 

System.out.println(i*i); 

} 


18. What is printed by the following program? 
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class ProblemlS { 

public static void main(String[] args) 
int i, j - 0; 
for (i = 1; i <6; i++) 
if (i > 4) 
break; 

else { 

■ * * 

j = i + i; 

System, out. print"ln("j= " + j + " 

} 

System.out.printl n("Fi nal j= " + j + 

} 

} 


{ 




Exercises 


1. Write a program that asks for the number of quarters, dimes, nickels, and pennies you have. Then com¬ 
pute the total value of your change and print the amount in the form $X. YY. See Exercise 15 on page 43 
in Chapter 2. 

2. Write a program that reads In two integers and then prints out the larger one. Use Review Question 8, on 
page 40, as a starting point and make the necessary changes to cl ass Pri ntMi n to produce cl ass 
Pri ntMax. 

3. Modify the class Average from this chapter to print a special message if the first number entered is 0. 

4. Write a program that reads in four integers and then prints out yes if the numbers were entered in 
increasing order and prints out no otherwise. 

5. Write a program that prompts for the length of three line segments as integers. If the three lines could 
form a triangle, the program prints “Is a triangle.” Otherwise, it prints “Is not a triangle.” Recall that the 
sum of the lengths of any two sides of a triangle must be greater than the length of the third side. For 
example, 20, 5, and 10 can’t be the lengths of the sides of a triangle because 5 + 10 is not greater than 20. 

2 2 2 

6. Write a program that tests whether the formula a + b = c is true for three integers entered as input. 
Such a triple is a Pythagorean triple and forms a right-angle triangle with these numbers as the lengths oi 
its sides. 

7. An operator that is mildly exotic is the conditional operator ?:. This operator takes three arguments and 
has precedence just above the assignment operators, as for example in 

s = (a < b)? a : b; 

// (a < b) true then s assigned a else s assigned b 

Rewrite the code for class Pri ntMi n, in Review Question 8, on page 74, using this operator to e limin ate 
the first two i f statements. We chose not to use this operator because it is confusing to beginning pro¬ 
grammers. It is unnecessary and usually can readily and transparently be replaced by an i f statement. 

8. Write a program that reads in integers entered at the terminal until a value of 0 is entered. A sentinel 
value is used in progr ammin g to detect a special condition. In this case the sentinel value is used to 
detect that no more data values are to be entered. After the sentinel is entered, the program should print 
out the number of numbers that were greater than 0 and the number of numbers that were less than 0. 

9. Write a program that reads in integers entered at the terminal until a sentinel value of 0 is entered. After 
the sentinel is entered, the program should print out the smallest number, other than 0, that was 

entered. 
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10. Rewrite Exercise 8 on page 76 to print the largest number entered before the sentinel value 0 is entered. 
If you already did that exercise, only a few changes are needed to complete this program. Now code a fur¬ 
ther program that ends up printing both the smallest or minimum value found and the largest or maxi¬ 
mum value found. 

11. Rewrite Exercise 5 on page 76 to continue to test triples until the sentinel value 0 is entered. 

12. Write a program to input values as in Excercises 8, 9, or 10 above. This time run it with the input taken as 
a file through redirection. If the compiled Java program is NumberTester.dass, then the command 

java NumberTester < myFile 

will use myFi 1 e for input. Redirection is possible with Unix or the Windows console window. This can 
save a lot of typing of input values for testing. 

13. Write a program to print every even number between 0 and 100. Modif y the program to allow the user to 
enter a number n from 1 through 10 and have the program print every nth number from 0 through i 00. 
For example, if the user enters 5, then 0 5 10 15 20...95 100 are printed. 

14. Write a program that will print out a box drawn with asterisks, as shown. 


A 

-v 


■A* 



rt 

n 



J- 








rt 







rt 



rt 


4.1* 



4.t* 










A 











* 


Use a loop so that you can easily draw a larger box. Modify the program to read in a number from the 
user specifying how many asterisks high and wide the box should be. 

15. Write a program that reads in numbers until the same number is typed twice in a row. Modify it to go 
until three in a row are typed. Modify it so that it first asks for “how many in a row should I wait for?” 
and then it goes until some number is typed that many times. For example, for two in a row, if the user 
typed “1 2 5 3 4 5 7” the program would still be looking for two in a row. The number 5 had been typed 
twice, but not in a row. If the user then typed 7, that would terminate the program because two 7s were 
typed, one directly after the other. 

16. Write a program that prints all the prime numbers in 2 through 100. A prime number is an integer that is 
greater than 1 and is divisible only by 1 and itself. For example, 2 is the only even prime. Wby? 

Pseudocode for finding primes 

for n = 2 until 100 

for i - 2 until the square root of n 

if n % i == 0 the number is divisible by i 
otherwise n is prime 

Can you explain or prove why the inner-loop test only needs to go up to the square root of n? 

17. Write a program that prints the first 100 prime numbers. Use the same algori thm as in Exercise 16 on 
page 77, but terminate the program upon finding the 100th prime. Assume that the search needs to go 
no farther than n = 10,000. 

18. Write a program that generates all Py thagorean triples (see Exercise 6 on page 76) whose small sides are 
no larger than n. Try it with n < 200. ( Hint. Use two for loops to enumerate possible values for the small 
sides and then test to determine whether the result is an integral square. 
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19. Write a program that gives you a different message each day of the week. Use a swi tch statement. Take 
as input an integer in the range 1 through 7. For example, if 6 means Friday, the message might say, 
Today is Friday, tGif.If the user inputs a number other than 1 through 7, have the default issue an 

appropriate message. 

20. Write a program that gives you a fortune based on an astrological sign. Use a swi tch statement to struc¬ 
ture the code. 


21. Write a program that generates an approximation of the real number e. Use the formula 


i+i+i+i 

1 ! 2 ! 3 ! 



where k\ means k factorial = 1 * 2 * . . . *k. Keep track of term l/k\ by using a double. Each iteration 
should use the previous value of this term to compute the next term, as In 


u+i T k x k+ i 


Rim the computation for 20 terms, printing the answer after each new term is computed. 


22. Write your own pseudorandom number generator. A pseudorandom sequence of numbers appears to be 
chosen at random. Say that all the numbers you are interested in are placed in a large fishbowl and you 
reach in and pick out one at a time without looking where you are picking. After reading the number, you 
replace it and pick another. Now you want to simulate this behavior in a computation. You can do so by 
using the formulaX n+ j — (aX n + c) mod m. Let a be 3,141,592,621, cbe 1, and mbe 10,000,000,000 
(see Knuth, Seminumerical Algorithms, Addison-Wesley 1969, p. 86). Generate and print the first 100 
such numbers as long integers. Let = 1. 



Applet Exercise 


Redo any one of the first ten exercises in this chapter but use an applet for input and output. You are to do 
so by modifying the following applet. Recall that the Applet exercise in Chapter 2, on page 44 introduced a 
special kind of java program called an applet. Among other things, an applet may be used to create graphical 
output such as plots or diagrams. In order to be useful, most programs, including applets, need some way to 
receive input. For the regular applications that we’ve created so far, we’ve used scan. nextlntQ, etc., to 
read values from the console. This exercise introduces you to the use of a UTextField object to get input 
from an applet. For this exercise we need to introduce two more methods: i ni t() and actionPerformed(). 
As with the earlier applet exercise, for now you need only to concentrate on the body of the methods i ni t () 
and actionPerformedO, treating the surrounding code as a template to be copied verbatim. The following 
applet reads two numbers and then displays their sum. 

/* <applet code="AppletSum.class" 

width=420 hei ght=100x/app1 et> */ 

//AppletSum.java - Text input with an applet 
import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 

public class AppletSum extends JApplet implements ActionListener 

{ 

JTextField inputOne = new JTextField(20); 

JTextField inputTwo = new JTextField(20); 

JTextField output = new 3TextField(20); 
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public void initQ { 

Container pane = getContentPaneO ; 
pane.setLayout(new FlowLayout()); 
pane.addCnew JLabel("Enter one number.")); 
pane.add(inputOne); 

pane.add(new JLabel("Enter a number and hit return.")); 
pane.add(inputTwo); 

pane.add(new JLabel("Their sum is:")); 
pane.add(output); 
inputTwo.addActionListener(this); 

} 

public void actionPerformed(ActionEvent e) { 
double first, second, sum; 

first = Double.parseDouble(inputOne.getTextO); 
second = Double.parseDoublefinputTwo.getfextQ) ; 
sum = first + second; 
output.setText(St ring.valueOf(sum)); 

} 

} 




Dissection of the AppletSum Program 

H import java.awt.*; 

import java.awt.event.*; 
import javax.swing.*; 

public class AppletSum extends JApplet implements ActionListener 

For now this code is all part of the template for an applet. The only part that you should change is to 
replace Appl etSum with the name of your applet. The import statements tell the Java compiler where to 
find the various classes used in this program, such as JTextFi el d and JAppl et. The extends J Appl et 
phrase is how we indicate that this class is defining an applet instead of a regular application. The 
i mpl ements Acti on Li stener phrase is needed if we want to have our program do something when the 
user has finished entering data. 

• JTextField inputOne * new JTextField(20); 

JTextField inputTwo = new JTextField(20); 

JTextField output = new JTextField(20); 

JTextFi el d is a standard Java class. A JTextFi el d is a graphical user interface component in which the 
user can enter text and the program can then read the text entered by the user. This program will create 
three text fields—two for the input values and one to display the sum of the first two. Note that these 
variables aren’t declared inside any method. These variables need to be referenced by both the methods 
in this applet. You should think of them as part of the applet class Appl etSum and not part of any one 
method. (We discuss such declarations in Section 6.9, Static Fields and Methods , on page 169.) 

• public void init() { 

Container pane = getContentPaneO; 
pane.setLayout(new FlowLayout()); 

The method i ni t () is rather like mai n () for an applet. This method is called to initialize i he applet. The 
first thing we do in the method is get the content pane. The content pane is the part of the applet used to 
display the various graphical components that we add to the applet. The set Layout () method is used 
to adjust the content pane so that when components are added, they are arranged in lines, like words of 
text in a word processor. The components are allowed to “flow” from one line to the next. For now, just 
always include the two statements in your i ni t () method. 
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m pane.add(new JLabel("Enter one number.")); 
pane.add(inputOne); 

pane.add(new JLabel("Enter a number and hit return.")); 
pane.add(inputTwo); 

pane.add(new JLabel("Their sum is:")); 
pane.add(output); 

The method add () is used to add some labels and text fields to the content pane of the applet. J Label is 
a standard Java class that is used to place labels in graphical user interfaces. Unlike with a JTextField, 
the user can’t enter text in a ] Label when the applet is running. The order in which we add all the com¬ 
ponents to t he applet is important. The components are placed in the applet, like words in a word pro¬ 
cessor. That is, the components will be displayed from left to right across the applet until the next 
component won’t fit, in which case a new line of components is started. Later, you’ll learn more about 
controlling the placement of components, but for now just add them in the desired order and then 
adjust the width of the applet to get the desired appearance. Here is what the applet will look like. 
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Applet started. 
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# inputTwo.addActionListener(this); 

The last statement in the ini t() method says that the actionPerformedO method in the applet 
referred to by thi s should be called when Return is hit in the text field, i nputTwo. 

H public void actionPerformed(ActionEvent e) { 
double first, second, sum; 

first = Double.parseDouble(inputOne.getTextO) ; 
second = Double.parseDouble(inputTwo.getTextO) ; 
sum = first + second; 
output.setText(String.valueOf(sum)); 

} 

This method is called each time the user hits Return with the cursor placed in the text field i nputTwo. 
The method gets the text that was entered in the first two text fields by invoking their getTextO meth¬ 
ods. The resul tin g strings are then converted to floating point numbers, using the standard Java method 
Doubl e. parseDouble(). Next the two numbers are added and stored in the variable sum. The floating 
point value stored in sum is converted to a String, using Stri ng . val ueOf (), which can be used to con¬ 
vert any p rimi tive value to a Stri ng. Finally the method setText () from the class JTextField is used 
to set the value of the text displayed in the JTextFi el d object output. 
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Structured programming is a problem-solving strategy 7 and a progr ammin g methodology that includes two 
guidelines. 


Structured Programming Guidelines 

• The flow of control in a program should be as simple as possible. 

• The construction of a program should embody top-down design. 

Top-down design, also referred to as stepwise refinement, consists of repeatedly decomposing a problem into 
smaller problems. Eventually, you have a collection of small problems or tasks, each of which can be easily 
coded. Object-oriented programming strategy 7 encompasses structured progr ammin g but has additional ele¬ 
ments, which we explain in Chapter 6, Objects: Data Abstraction. 

The method construct in Java is used to write code that solves the small problems that result from this 
decomposition. Methods are, in classical programming terms, functions or procedures . Methods are combined 
into further methods and ultimately used to solve the original problem. Some methods, such as Sys- 
tem. out .println(), are provided by the system; others are written by the programmer. 

We illustrate structured programming and top-down design in this chapter, but first we describe the method 
mechanism in more detail. 
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4.1 METHOD INVOCATION 


A simple program is made up of one or more methods contained in a class, one of them being mai n (). In 
these simple cases, program execution begins with mai n (). When program control encounters a method 
name followed by parentheses, the method is called , or invoked. That is, program control passes to the 
method. .After the method does its work, program control is passed back to the calling environment, where 
program execution continues. As a simple example, consider the following program, which prints a message. 

// Message.java: Simple method use 
class Message { 

public static void main(String[] args) { 

System.out.println("HELLO DEBRA!"); 

printMessageO ; //method call 

System,out.println("Goodbye."); 

} 

//definition of method printMessage 
static void pri ntMessageO { 

System.out.println("A message for you: "); 

System.out.println("Have a nice day!\n"); 

} 

} 

The method definition includes the name of the method and a method body. The method body is a block that 
is executed when the method is invoked. Program execution begins in mai n(). When program control 
encounters pri ntMessageO, the method is called, or invoked, and program control is passed to it. After the 
two println() statements in pri ntMessageO have been executed, program control passes back to the call¬ 
ing environment, which in this example is in mai n (). In mai n (), the program finishes by printing “Goodbye.” 

System. out .pri ntl n ("HELLO DEBRA! ") is also a method call, as are the two statements that constitute the 
body of the method pri ntMessageO. Because println() isn’t defined in the class Message, we need to tell 
the computer where to find pri ntl n(); hence the System.out preceding the method name. We present the 
details of how the method names are used in Section 6.10, Calling Methods~A Recap , on page 171. The com¬ 
plete sequence of calls for this program is as follows. 

The system calls main() to start the program. 
main() calls System.out.println(). 

"HELLO DEBRA!" is printed. 

System.out.println() returns. 
main() calls pri ntMessageO . 

pri ntMessageO calls System.out.printlnO . 

"A message for you: "is printed. 

System.out.println()returns. 
pri ntMessageO calls System.out. pri ntln() 

"Have a nice day!\n" is printed 
System.out.println() returns, 
pri ntMessageO returns. 
main() calls System.out.printlnO . 

"Goodbye." is printed. 

System.out.println() returns. 
main() returns to the system. 

The program ends. 
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STATIC METHOD DEFINITIONS 


The simplest methods are called class methods or static methods. (You will learn about a different type of 
method in Chapter 6, Objects: Data Abstraction.) The general form for static methods is 

static RetumType Identifier ( ParameterList ) block 

The block —also known as the method body of the method definition—contains variable declarations and 
statements that are executed when the method is called. The variables declared in the method’s block are 
said to be within the scope of the method (see Section 4.4, Scope of Variables, on page 86). The RetumType of 
the method is the type of the value returned by the method. For example, Math. sqrt() returns a double 
that can be used in an expression such as Math. sqrt (x) + y. If nothing is returned, as in our example 
pri ntMessage (), the keyword voi d is used. The optional ParameterList describes the number and types of 
the arguments that are passed to the method when it is invoked. If no arguments are passed, the list is 
empty. 

The parameters in the parameter list are variables and can be used within the body of the method. Some¬ 
times the parameters in a method definition are called formal parameters to emphasize their role as place¬ 
holders for actual values that are passed to the method when it is called. Upon method invocation, the value 
of the actual argument corresponding to a formal parameter is used to initialize the formal parameter, as 
shown in the next example. 

The keyword pub! i c is optional, except with the method mai n () . This requirement for publ i c with mai n () 
isn’t part of the Java syntax; rather, it is part of the specification of how to run a Java program. We discuss 
public and other method access modifiers in Section 6.7, Access public and private: Data Hiding, on page 
167. 

To illustrate these ideas, we can rewrite the preceding program so that the method pri ntMessage () has a 
formal parameter. The parameter is used to specify how many times the message is to be printed. 

i * 

// Message2.java: method parameter use 
class Message2 { 

public static void main(String[] args) { 

System.out.println("HELLO DEBRA!"); 

printMessage(S); //actual argument is 5 

System.out.println("Goodbye.; 

} 

static void printMessage(int howManyTimes) { 

//formal parameter is howManyTimes 
System.out.println("A message for you: "); 
for (int i =0; i < howManyTimes; i++) 

System.out.println("Have a nice day!\n"); 

} 

} 




Dissection of the Message2 Program 


• class Message2 { 

A simple program is a collection of methods within a class. The class Message2 encapsulates the various 
method definitions. The method mai n () begins executing first. 
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% printMessage(S); //actual argument is 5 

This line is the method call for pri ntMessageQ. The actual argument is the constant 5, which is passed 
to the method and used to initialize the formal parameter howManyTi mes. 

static void printMessage(int howManyTimes) { 

The return type is voi d, which tells the compiler that the method doesn’t return a value. In program¬ 
ming language terminology such a method is called a pure procedure as opposed to a function, which 
returns a value. The parameter list is i nt howManyTi mes, which tells the compiler that the method takes 
a single argument of type i nt. The parameters specified in the definition of a method are called formal 
parameters. For now, methods must be declared as stati c. We discuss nonstatic methods when we 
introduce object-oriented programming in Chapter 6 , Objects: Data Abstraction . 

System.out .pri ntln("A message for you: **) ; 
for (int i =0; i < howManyTimes; i++) 

System.out.println("Have a nice day!\n n ); 

} 

The code between the braces constitutes the body of the method definition for pri ntMessage (). If how¬ 
ManyTi mes has the value 5, the message is printed five times. When program control reaches the end of 
the method, control is passed back to mai n () 



Common Programming Error 

A common mistake is to forget to include static in the definition of a method, la Section 6.3, Instance 
methods , on page 161, we discuss methods that don’t include stati c and how they are called. If you 
leave static out of the method definition but then try to call a method following the example in this 
section, then you will get an error message similar to 

Can't make static reference to method returnType methodName(parameterTypes) in 
class YourClass . 

This message may also include some indication of where the invalid method invocation is located. This 
message can be confusing at first because it isn’t the invocation that’s at fault. The error is in the decla¬ 
ration of the method being invoked. 



4.3 THE return STATEMENT 


When a return statement is executed within a method, program control is immediately returned to the point 
right after the call to the method; if an expression follows the keyword return, the value of the expression is 
also returned to the calling environment. Some examples are 

return; 
return a; 

return (a * b + c); 

You can enclose the expression being returned in parentheses. If the expression is complicated, it is consid¬ 
ered good programming practice to do so. 
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There can be zero or more return statements in a method. If there is no retu rn statement, control is passed 
back to the calling environment when the closing brace of the body is encountered. This action is called fall¬ 
ing off the end and is permitted only when the return type is voi d. To illustrate the use of return state¬ 
ments, we can write a program that computes the minimum of two integers. 

// Min2.java: return expression in a method 
class Min2 { 

public static void main(String[] args) { 
int j = 78, k = 3 * 30, m; 

System.out.println( ,f Minimum of two integers Test:'’); 
m - minCj , k) ; 

System.out.printlnC’The minimum of : " + j + " , " + k + " is " + m) ; 

} 

static int min(int a, int b) { 
if (a < b) 
return a; 
el se 

return b; 

} 

} 
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Dissection of the Min2 Program 

# public static void main(String[] args) { 

int j = 78, k = 3 * 30, m; 

The variables j, k, and m are declared to be of type i nt. The variables j and k are assigned constant 
expressions for test purposes. We could modify the program to request values as input using scan. nex- 
tlntQ. 


m 


min(i, k); 


The values of j and k are passed as actual arguments to mi n (). The method mi n () returns a value, 
which is assigned to m. 

# static int min (int a, int b) 

This line is the header of the method definition for mi n(). The return type of the method is i nt. The 
value returned from within the method will be converted, if necessary, to an i nt lief ore it is returned to 
the calling environment. The parameter list 

# int a, int b 

declares a and b to be of type int. The formal parameters are used in the body of the method definition. 


# ( 


if (a < b) 
return a; 
el se 

return b; 


} 


The code between the braces constitutes the body of the method definition for mi n(). If the value of a is 
less than the value of b, the value of a is returned to the calling environment; otherwise, the value of b is 
returned. 
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Even small methods such as mi n() provide useful structuring to the code. In a real program, there might be 
several places in the code where the minimum of two numbers is needed. Without the method mi n(), we’d 
end up with something like 


if (a < b) 
x = a; 
el se 
x = b; 

• • * 

if (c < d) 
y = c; 
el se 

y = d; 


Using our method mi n () changes this code to 


x = min(a, b) ; 

* m ■ 

y = min(c, d); 


The latter code is both shorter and easier to read, making the overall structure of the program clearer. 
Another important benefit is that we need to debug only the code that finds the minimum once. In the ver¬ 
sion without the method mi n(), because we have to type the conditional statement each time we want the 
minimum, we are much more likely to make an error. 

If we want to modify our program so that the maximum value is also computed, we can use a method max() 
to do so. We have to add its method definition to the class Mi n2. Here is the method definition. 

static int max(int a, int b) { 
if (a > b) 
return a; 
el se 

return b; 

} 



4.4 SCOPE OF VARIABLES 


Variables such as j and k in mai n() for the class Mi n2 are called local variables —they can be accessed only 
“locally” or “nearby.” For example, you can’t refer to the variable j declared in mai n() of Mi n2, from within 
mi n(). 

The scope of a variable is the range of statements that can access the variable. The scope of a local variable 
extends from the point where the variable was declared (where it was first mentioned and given a type, as in 
int j ;) to the end of the block containing the declaration. Recall from Section 3.1, Expression, block, and 
empty Statements , on page 47 that a block is a group of statements delimited by braces. A formal parameter 
is essenti all y a special kind of local variable. Hence the scope of a formal parameter is the entire definition of 
the method. 


If it weren’t for scope’s ability to limi t the accessibility of local variables, we might have been tempted to 
write class Mi n2 as follows. 
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// Min2Bad.java - doesn't work because of scope 
class Min2Bad { 

public static void main(Strinq[1 arqs) { 
int j - 78, k = 3 * 30, m; 

System.out.println("Minimum of two integers Test:"); 
m = mi n() ; 

System.out.println("The minimum of : " + j + " , " + k + " is " + m); 

} 

static int min() { 
if (j < k) 
return j; 
el se 

return k; 

} 

} 

This code won’t compile because the variables j and k can’t be referenced outside method mai n(), as we 
attempted to do in method mi n(). In order for mi n() to compare the values for two local variables in 
mai n(), those values must be passed as parameters to mi n (), as we did in the correct version earlier. 

The scope of a variable declaration in the initialization portion of a for loop is the loop body plus the update 
and loop termination expressions. Declaring the Index variable for a for loop in the for loop is quite com¬ 
mon. In that case the loop index variable won’t be accessible after the loop, as shown in this example. 

double squareRoot; 
for (int x = 1; x <= 10; x++) { 
squareRoot = Math.sqrt(x); 

System.out.println("the square root of " + x + " is " + squareRoot); 

} 

System.out.println("x = " + x); //Syntax error 

Note that the use of declarations inside blocks could result in two variables with the same name having over¬ 
lapping scopes. Java, however, disallows a local declaration that conflicts with another local declaration. In 
the following example, the second declaration of squareRoot is illegal because there is already a local decla¬ 
ration for squareRoot that extends into the block that is the body of the for statement. Likewise, the defini¬ 
tion of i in the for statement is illegal. Also, the final print of square is illegal because the scope of square 
ends at the brace that ends the for statement. 


// SquareRoots2.java - contains scope errors 
public class SquareRoots2 { 

public static void main(String[] args) { 
int i = 99; 

double squareRoot = Math.sqrt(i); 


} 


System.out.println("the square root of ” + i + " is " + 
for (int i = 1; i <=10; i++) { 
double squareRoot = Math.sqrt(i); 
double square = squareRoot * squareRoot; 

System.out.println("the square root of " + i + " is " 
System.out.println("squaring that yields " + square); 

} 

System.out.println( M The final value of square" + " is " 


squareRoot); 


+ squareRoot); 


+ square); 


} 
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Dissection of the SquareRoots2 Program 

# public class SquareRoots2 { 

public static void main(String[] args) { 
int i = 99; 

double squareRoot = Math.sqrt(i); 

The scope of these declarations extends to the end of the method mai n(). 

% for (int i = 1; i <=10; i++) { 

double squareRoot = Math.sqrt(i); 

The declaration of i in the f o r statement initiahzation part is illegal because i was already declared in 
this method. Likewise the declaration of squareRoot is illegal. These declarations are illegal because we 
can’t have two local variables with overlapping scopes that have the same name. 

Some program m ing languages allow overlapping, giving precedence to the innermost definition, but Java 
doesn’t. This restriction simplifies the language and adds to program clarity. In this program, the error 
can easily be eliminated by removing the type declarations so that the two lines become 

for (i =1; i <=10; i++) { 
squareRoot = Math.sqrt(i); 
double square = squareRoot * squareRoot; 

The scope of this definition of square extends only to the end of the for statement. 

% System.out.println("the square root of " + i + " is " + squareRoot); 

System.out.println(”squaring that yields 11 + square); 

} 

System.out.pri ntl n( u The final value of square" + " is " + square); 

The first pri ntl n() involving square is within the scope of square so it is fine. The second is beyond 
the scope of square and will result in a syntax error at compile time. A solution would be to declare 
square before the for statement. 



4.5 TOP-DOWN DESIGN 


Imagine that you have to analyze some company data represented by a series of integers. As you read each 
integer, you want to print out the count of integers read, the integer, the sum of all the integers read up to 
this point, the minimum integer read up to this point, and the maximum integer read up to this point. In 
addition, suppose that a banner must be printed at the top of the page and that all the information must be 
neatly printed in columns under appropriate headings. To help you construct this program, we decompose 
the problem into the following subproblems. 

Decomposing the running sum program 

1. Print a banner. 

2. Print the headings over the columns. 

3. Read the data and print them neatly in columns. 
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You can code each subproblem directly as a method. Then you can use these methods in mai n () to solve the 
overall problem. Note that by designing the code this way, you can add further methods to analyze the data 
without affecting the program structure. 

//RunSums.java: top level, main(), calls methods to 
// handle subproblems 
import java.uti1.*; 
import static java.lang.Math.*; 

class RunSums { 

public static void main(String[] args) { 
printBanner(); 
printHeadings(); 
readAndPrintDataC); 

} 

// printBanner, printHeadings and readAndPrintData 
// definitions will go here 


} 


This program fragment illustrates in a very simple way the idea of top-down design. Think of the tasks to be 
performed and code each task as a method. If a particular task is comphcated, you can subdivide it into 
smaller tasks, each coded as a method. A further benefit is that the program as a whole is more readable and 
seh-documentmg. There may be many ways to decompose a problem into methods. Much of the art of pro¬ 
gram design lies in finding a good decomposition. 


Coding the individual methods is straightforward. The first method contains a single pri ntl n() statement 


static void printBanner() { 
System,out.println("\n" + 
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The next method writes headings over columns. Similar to \n being used to indicate a newline, \t is the 
escape sequence for a tab character. Words appear separated by a tab. 

static void printHeadings() { 

System, out. pri ntl n( n Count\tItem\tSum\tMi ni mum\tMaximum ,, ) ; 

} 


Most of the work is done in readAndPri ntData(). 

static void readAndPrintDataC) { 

int cnt = 0, sum = 0, item, smallest, biggest; 

Scanner scan = new Scanner(System.in); 
item = scan.nextlntQ; 
smallest = biggest = item; 
while (item != -99999) { 
cnt++; 

sum = sum + item; 

smallest = min(item, smallest); 

biggest = max(item, biggest); 

System.out.println( cnt + "\t" + item + ”\t" + sum + "\t" + 

smallest + "\t M + biggest); 
item = scan.nextlntO ; 

} 


} 
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If we execute the program and enter data directly from the keyboard, we get the echoing of input characters 
and the output of the program intermixed on the screen. To prevent this problem, on systems with redirec¬ 
tion such as Unix, we create a file called data containing the integers 

19 23 -7 29 -11 17 -99999 


Most Java IDEs allow you to specify a file to be used for input in place of the keyboard. If you’re running Java 
from a Unix or Windows command line you can use the command 


java RunSums < data 

This procedure is called file redirection because you’re redirecting the program to read from a file instead of 
from the keyboard. In Chapter 10, Reading and Writing Files we discuss how to do file I/O more generally. 
Here’s what is printed on the screen. 
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Item 
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1 

19 

19 

19 

19 

2 

23 

42 

19 

23 

3 

-7 

35 

-7 

23 

4 

29 

64 

-7 

29 

5 

-11 

53 

-ii 

29 

6 

17 

70 

-11 

29 




Dissection of the readAndPrintDataQ Method 


# static void readAndPrintDataQ { 

int cnt = 0, sum = 0, item, smallest, biggest; 

The header of the method definition is the single line before the brace. The method doesn’t return a 
value, so its return type is void. The method takes no arguments. In the method definition, the variables 
cnt, sum, item, smallest, and biggest are declared to be of type int. The variables cnt and sum are 
initialized to zero. The initial value of the variable i tern is taken from the console. The initial values of 
the variables smal 1 est and bi ggest are computed. 

• item = scan.nextlntQ ; 
smallest = biggest = item; 

The first i tern is read in. The variables smal 1 est, and bi ggest are assigned the value of i tern . Recall 
that bi ggest = i tem is an expression using the assignment operator. The value of such an expression 
is the same as the expression on the right-hand side of the assignment operator. Thus we can use the 
expression bi ggest '= i tem as the right-hand side expression assigned to smal 1 est. 
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U while (item != -99999) { 
cnt++; 

sum = sum + item; 

smallest = min(item, smallest); 

biggest = max(item, biggest); 

System.out.println( cnt + "\t" + item + ”\t n + sum + *\t + 

smallest + "\t" + biggest); 

item = scan.nextlntO; 

} 

The integer value -99999 is a sentinel value intended to terminate the loop. After the first integer has 
been obtained from the console, we use this whi 1 e loop to find others. Each time the body of this while 
loop is executed, the variable cnt is incremented by 1, sum is incremented by the current value of item, 
smal 1 est is assigned the minimum of the current values of i tern and smal 1 est, bi ggest is assigned 
the maximum of the current values of i tern and bi ggest, and all these values are printed in the appro¬ 
priate col umn s. Recall that \t prints a tab. Eventually, nextlntQ is supposed to read -99999 from the 
console, causing the while loop to end. We investigate in the exercises other ways to end this loop. 




4.6 PROBLEM SOLVING: RANDOM NUMBERS 


Random numbers have many uses in computers. One use is to serve as data to test code; another use is to 
simulate a real-world event that involves a probability. The method of simulation is an important problem¬ 
solving technique. Programs that use random number methods to generate probabilities are called Monte 
Carlo simulations. The Monte Carlo technique can be applied to many problems that otherwise would have 
no possibility of solution. 

A random number generator is a method that returns numbers that appear to be randomly distributed 
within some interval. The method Math. random () in the standard package java. 1 ang is provided to do this 
for numbers between 0 and 1, including 0 but not 1, that is [0, 1). The following program fragment displays 
some random numbers generated by Math. random (). 

//RandomPrint.java: Print Random numbers in the range [0.0 - 1.0). 
class RandomPrint { 

public static void main(String[] args) { 
int n = 10; 

System.out.println("We will print " + n + ” random numbers”); 
printRandomNumbers(n); 

} 

static void printRandomNumbers(int k) { 
for (int i =0; i < k; i++) 

System.out.println(Math.random()); 

} 


We can add to this class methods for max() and mi n(), which we’ve already discussed. We can modify 
pri ntRandomNumbers () to print out the largest and smallest random number found. 
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static void printRandomNumbers(int k) { 
double r, biggest, smallest; 
r - biggest - smallest = Math. randomO; 
System.out.print(" " + r); 

for (int i = 1; i < k; i++) { 
if (i % 2 == 0) 

System.out.pri ntinQ ; 
r = Math. randomO ; 
biggest = max(r, biggest); 
smallest = min(r, smallest); 

System.out.print(" " + r); 

} 


} 


System.out.println( M \nCount: " + k + "\nMaximum: 

"\nMinimum: " + smallest); 


" + biggest + 


Before we dissect this method definition, let’s see what the output of the program looks like. If we run this 
program, the following appears on the screen. 


We will print 10 random numbers 
0.016657093696542113 0.9872859969278116 
0.03331371015770079 0.5954234589013508 
0.667160647102587 0.6878910499886401 
0.2268455586583925 0.022606516838095003 
0.4565489420647485 0.49292751841170546 
Count: 10 

Maximum: 0.9872859969278116 
Minimum: 0.016657093696542113 




Dissection of the printRandomNumbersQ Method 


# static void printRandomNumbers(int k) { 
double r, biggest, smallest; 

The variable k is a parameter declared to be an i nt. The variables r, biggest, and smallest are all 
declared to be of type doubl e. 

fjj r = biggest % smallest = Math. randomO ; 

The method Math .randomO from the class j ava. 1 ang . Math is used to generate a random number. 
That number is assigned to the variables r, bi ggest, and smal 1 est. The random number is between 0.0 
and 1.0 with 0.0 included but 1.0 excluded. 
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# for (int i =1; i < k; i++) { 
if (i % 2 == 0) 

System.out„println(); 
r = Math. randomQ ; 
biggest = max(r, biggest); 
smallest = min(r, smallest); 

System.out.print(" " + r); 

} 

This f o r loop is used to print the remaining k - 1 random numbers. Because one random number has 
already been printed, the variable 1 at the top of the loop is initialized to 1 rather than 0. Whenever i is 
divisible by 2, the expression 

i % 2 — 0 

controlling the i f statement is true, causing a newline character to be printed. The effect of this is to 
print two random numbers on each line, except possibly the last which will have only one if an odd num¬ 
ber of random numbers are printed. This idiom is commonly used for printing several values on one line. 




4.7 A SIMULATION: PROBABILITY CALCULATIONS 


A common use of computers is to simulate some activity that goes on in the real world. Computer simula¬ 
tions can often be used in place of a dangerous or costly experiment. Another advantage of computer simula¬ 
tions is that they can compress time. Instead of taking years to watch some natural process, a simulation of 
that process can be done in minutes or hours. Of course, the simulation generally has to be based on some 
simplifying assumptions, but the results still can be useful. 

Let’s use a computer to simulate the repeated tossing of a coin. We want to find the probability that we can 
toss some number, n, heads in a row. This experiment is neither expensive nor dangerous, but we can com¬ 
press time with it. In less than a second (not counting the time to write the program) we can simulate tossing 
a coin millions of times. 

This program uses a sequence of random numbers between 0 and 1 to simulate the coin tosses. If the next 
random number in the sequence is less than 0.5, it will be considered a head; if the number is greater than or 
equal to 0.5, it will be considered a tail. We will conduct many trials, each trial attempting to “toss” n heads in 
a row. If the trial succeeds by tossing n heads in a row, we will count the trial as a success. If the trial fails, by 
tossing a tail before n heads have been tossed, we will count the trial as a failure. The probability that we can 
toss n heads in a row is approximately the ratio of successful trials to total trials. By increasing the number 
of trials, we can increase the accuracy of our result. 

The following is a pseudocode solution to the problem. 

Pseudocode for Coin Toss Simulation 

Input the number of heads in a row for a trial. 

Input the number of trials to run. 

Perform the specified number of trials. 

Print the result. 

We can refine how to perform the specified number of trials as follows. 
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Pseudocode for performing the specified number of trials 

initialize the number of successes to 0 
while there are more trials to run 
run one trial 

if the trial was a success 

increment the number of successes 
end while loop 

return the number of successful trials 

Remember: Pseudocode is an informal notation intended for human beings, not computers. We use indenta¬ 
tion to indicate nested statements. We can refine this pseudocode further by detailing how to perform one 
trial. 


Pseudocode for performing one trial 

let numTosses be the number of tosses for a successful trial 
initialize the number of heads tossed to zero 
while number of heads tossed is less than numTosses 
toss the coin 

if the coin comes up tails 
return failure 

increment the number of heads tossed 
end while loop 
return success 

At this point we are almost ready to begin writing the code. As discussed in the preceding section, we can use 
the method Math . random() in the standard package java . 1 ang to generate random numbers for the inter¬ 
val [0, 1). This method will return a value of type double that is greater than or equal to 0 and less than 1. If 
the double returned by Math. random() is less than 0.5, it will be considered heads; if it is greater than or 
equal to 0.5, it will be considered tails. The following is the complete program. We coded each section of the 
pseudocode as a separate method. 

//CoinToss.java - Compute the approximate probability 
// of n heads in a row by simulating coin tosses. 

class CoinToss { 

public static void main(String[] args) { 

//Input the number of tosses in a row to try for. 

int numTosses = 4; //lust use 4 for testing 

//Input the number of trials to run. 

int numTrials = 10000; //Use 10000 for testing 

//Perform the specified number of trials 

int numSuccesses = performTrials(numTosses,numTrials); 

//Print the results 

double probability = numSuccesses / (double)numTrials; 

System.out.println("Probability found in " + numTrials + " is " + 

probability); 


} 
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// return true if numTosses heads are tossed 
// before a tail 

static boolean isAl!Heads(int numTosses) { 
double outcome; 

for (int numHeads = 0; numHeads < numTosses; numHeads++) { 
outcome = Math. randomQ ; // toss the coin 

if ( outcome < 0.5) 

return false; // tossed a tail 

} 

return true; // tossed all heads 


// perform numTrials simulated coin tosses 
// and return the number of successes 

static int performTrials(int numTosses, int numTrials) { 

System.out.println("Monte Carlo " + numTosses + " in a row heads 1 '); 
int numSuccesses = 0; 

for (int trials= 0 ; trials < numTrials; trials++) 

// perform one trial 

if ( isAl1 Heads(numTosses)) 

numSuccesses++; // trial was a success 

return numSuccesses; 

} 

} 




Dissection of the CoinToss Program 


class CoinToss { 

public static void main(String[] args) { 

//Input the number of tosses in a row to try for. 
int numTosses = 4; //Just use 4 for testing 

//Input the number of trials to run. 
int numTrials = 10000; //Use 1000 for testing 


The code for mai n () follows directly from the pseudocode presented earlier. The comments correspond 
directly to the pseudocode. When you’re actually writing the code, a good first step is to put in the 
pseudocode as comments. Then either replace the comment/pseudocode with real code, or when appro¬ 
priate, leave the pseudocode as a comment and add the real code below the comment. In this example 
we decided to hardcode some input, that is, to insert some test values directly into the program. The 
comments indicate that we should be reading in the parameters for the program, but instead we simply 

assign some fixed value. We can easily replace these hardcoded assignments with calls to nextlntO or 
some other input method. 


• //Perfo rm the specified number of trials 

int numSuccesses = performTrials(numTosses,numTrials); 


Here we decided to create a separate method to perform the series of trials. That method will need the 
number of trials to perform and the number of tosses used to determine whether a trial is a success or a 
failure. The comment from the pseudocode is almost superfluous because the name of the method and 
variable names should make clear what is happening. We decided to leave the comment because it 
emphasizes how we derived this code from the pseudocode. 
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f> //Print the results 

double probability = numSuccesses / (double)numTrials; 

System.out.println( n Probability found in " + numTrials + " is " + 

probability); 

We can now compute the estimated probability of tossing numTosses heads in a row by dividing the 
number of successful trials by the total number of trials. Because numSuccesses and numTrial s are 
both integers, we must first cast one of them into a doubl e. Otherwise, the result of the integer division 
would always be zero in this example. 

# static boolean isAHHeads(int numTosses) { 
double outcome; 

for (int numHeads = 0; numHeads < numTosses; numHeads4-+) { 
outcome = Math. randomQ; // toss the coin 

if ( outcome < 0.5) 

return false; // tossed a tail 

} 

return true; // tossed all heads 

} 

This method is the key to simulating tossing a coin. If the next numTosses are aU heads, then the method 
returns true. If a tail is tossed before numTosses heads are tossed, then the method immediately returns 
false. In the exercises, we modify this routine to make other calculations, such as the probability of toss¬ 
ing k - 1 heads in k tosses. 

H static int performTrials(int numTosses, int numTrials) { 

System.out.println("Monte Carlo " + numTosses + " in a row heads"); 
int numSuccesses = 0; 

for (int trials = 0; trials < numTrials; trials++) 

// perform one trial 

if ( isAHHeads(numTosses)) 

numSuccesses++; // trial was a success 

return numSuccesses; 

} 

This method directly follows the pseudocode presented for Performing the Specified Number of Trials. 
Each iteration of the loop performs one trial by calling i sAl 1 Heads(), testing the result, and if it was a 
success, incrementing the count of successful trials stored in numSuccesses. 




4.8 INVOCATION AND CALL-BY-VALUE 


To call one method from another method in the same class, we write the name oi the called method and an 
appropriate list of arguments within parentheses. We have done so many times, as for example in i sAl 1 - 
Heads(n) or mi n(x, y). These arguments must match in number and type the parameters in the parameter 
list in the method definition. The arguments are passed call-by-value . That is, each argument is evaluated, 
and its value is used within the called method to initialize the corresponding formal parameter. Thus if a 
variable is passed to a method, the stored value of that variable in the calling environment won’t be changed. 

In the following example we attempt to swap the values of two local variables using a method. 
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4.9 Problem Solving: A Computer Came 

//FailedSwap.java - Cal 1-By-Value test 
class FailedSwap { 

public static void main(String[] args) { 
int numOne = 1, numTwo = 2; 
swap(numOne, numTwo); 

System.out.println("numOne = " + numOne); 

System.out.println("numTwo = n + numTwo); 

} 

static void swap(int x T int y) { 
int temp; 

System.out.println("x = " + x) ; 

System.out. pri ntl n("y = 11 + y) ; 
temp = x; 
x = y; 
y = temp; 

System.out.println("x = " + x); 

System.out.printlnC'y = " + y) ; 

} 

} 

The output of this program is 


x = 1 

V = 2 
x = 2 

y = i 

numOne = 1 
numTwo = 2 


Note that, although we successfully swapped the values of the formal parameters, x and y, doing so had no 
effect on the actual arguments, numOne and numTwo. The formal parameters are effectively local variables in 
the method swapO that have their values initialized with the values of the corresponding actual arg um ents. 
Five memory locations are identified in this program for storing integers: numOne, numTwo, x, y, and temp. 

In Java we can’t write a method swapO similar to the one presented that actually swaps the values of two 
primitive type variables passed as parameters. If swapO had actually caused the values in mai nO to change, 
then we would have said that it achieved its result by causing a side effect , instead of returning a value. The 
side effect would have been the changes in the two actual arguments. Any method with a return type of 
void, must cause some side effect or else be a completely useless method. The method pri ntl n() is an 
example of a method that does its job via a side effect. In the case of printlnO the side effect is the produc¬ 
tion of output on the console. In Section 5.3, Passing Arrays to Methods , on page 125, we will explain how we 
can cause side effects to data when passing nonprimitive types, such as class types or array types, as param¬ 
eters. 



4.9 PROBLEM SOLVING: A COMPUTER GAME 


Most programs begin as imprecise ideas in someone’s min d. For very small programs, the person who thinks 
up the idea may be able just to sit down and enter the code for the program. This approach is not good for 
anything but the smallest programs. Instead, a program usually goes through a development process. Of the 
many different software development processes, most roughly follow the software life cycle described 
shortly. However, the steps don’t always follow one after the other. For example, the implementation and 
testing steps are often performed iteratively, with some testing being performed as implementation pro¬ 
ceeds. 
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The Software Life Cycle 

1. Requirements analysis and definition: The requirements for the program are written in a form 
understandable by those who want the software created. They typically aren’t programmers. 

2. Design: A detailed design of the software is created. For large programs that involves breaking 
the program into smaller pieces with precise specification of how the various pieces will interact. 

3. Implementation: The code is actually written at this point. 

4. resting: The software must be thoroughly tested. For commercial software, fixing an error 
before the software has been released for use by the eventual customers is much cheaper than 
fixing it later. 

5. Maintenance: This phase is often the longest and most costly part of the program’s life cycle. 
Rarely is a large program never changed after it is put into use. The changes that occur during 
the maintenance phase are to fix errors discovered after a program has gone into use and, 
because program requirements evolve over time, modify existing features or add new features. 

A popular use of computers is for game playing. In this section we demonstrate the first four steps in the 
software life cycle of a small computer game. The game is called Twenty-One Pickup. 


4.9.1 TWENTY-ONE PICKUP: REQUIREMENTS ANALYSIS AND DEFINITION 

We begin our requirements analysis with a simple statement of the rules of the game. 

Twenty-One Pickup is a two-player game that starts with a pile of 21 stones. Each 
player takes turns removing 1, 2, or 3 stones from the pile. The player that removes 
the last stone wins. 


Several requirements need to be specified for this program. To do so, we need to answer the following ques¬ 
tions. 

1. What is the role of the computer? Will it be one of the players or will it simply enforce the rules 
and display the progress of a game between two human players? 

2. What will be the interface between the human being and the computer? For example, will the 
program have a graphical user interface or will the interface be a simple text display? 

3. Does the program play a sequence of games, keeping track of the number of games won by the 
various players, or does the program play one game and then exit? 

We answer these questions in the following way. 

1. The computer will be one of the players with a human being as the other player. The human 
player will always be allowed to go first. 

2. For this version of the program a simple textual interface will be used. The computer will print 
instructions, prompts, and results at the console and will read user input from the console. 

3. The program will play only a single game. There will be no tabulation of winners from one game 
to the next. 


4.9.2 TWENTY-ONE PICKUP: DESIGN 

We are now ready to begin designing the actual program. We specify precisely how the user and the com¬ 
puter will interact, and we use top-down design to develop the program structure. We begin the design with 
pseudocode for the top level of the program. 

Top-level pseudocode for Twenty-One Pickup 

print instructions 




































99 


4.9.2 Twenty-One Pickup: Design 

create the initial pile with 21 stones 

while the game is not over 
have the user move 
if the game is not over 
have the computer move 
end while loop 
print the outcome 

This pseudocode reflects the design decision that the user will always get to move first. It also reflects the 
decision that the program will play only a single game. We continue our design by expanding the “have the 
user move” and “have the computer move” subproblems. 

Pseudocode for “have the user move” 

get the user move from the console 
remove the stones from the pile 
print the user's move on the console 

This pseudocode reflects the design decision that we will be prompting the user to input his or her move at 
the console. The pseudocode for the “have the computer move” step is similar. 

Pseudocode for “have the computer move” 

compute number of stones for the computer to remove 
remove the stones from the pile 
print the computer's move on the 

To make our program robust, we designed a user input routine that checks to make sure the user has entered 
a valid move. If not, we prompt the user again until a valid move is entered. 

Pseudocode for “get the user move from the console” 

prompt the user for the user’s next move 
from the console, read the number of stones to remove 
while the number read is not a legal move 
prompt the user again 
read the number of stones to remove 
end while loop 

return the number of stones to remove 

We complete the design phase of program development by identifying the inputs and outputs for each of the 
major methods. In doing so we create a method for each piece of pseudocode presented. The following is the 
opening comment and method header for each of the major methods except mai n (). These comments are 
formatted as javadoc comments. We briefly discuss javadoc in Section 4.13, Programming Style , on page 111. 
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ri /t 

* playerMove completes one move by the player. 

* ©param numberOfStones - The number of stones reamining in the pile. 

* ©return The number of stones remaining after the user's move. 

V 

static int playerMove(int numberOfStones) 


* computerMove completes one move by the computer. 

* ©param numberOfStones - The number of stones reamining in the pile. 

* ©return The number of stones remaining after the computer's move. 

*/ 

static int computerMove(int numberOfStones) 


* getUserMove reads in the user's move, only accepting legal inputs. 

* ©param numberOfStones - The number of stones reamining in the pile. 

* ©return The number of stones selected for removal by the user. 

V 

static int getUserMove(int numberOfStones) 

In this design we decided that the userMoveO and computerMove () methods will take the current number 
of stones as input and return, as a result, the number of stones remaining after the move. We also pass the 
number of stones remaining to the method getUserMove(). That allows getUserMove() to make sure that 
the user doesn’t attempt to remove more than the remaining number of stones in the pile. 

We are now ready to move to the implementation phase wherein we complete the bodies of the methods. 


4,93 TWENTY-ONE PICKUP: IMPLEMENTATION 

Once we’ve completed the design we can begin writing the actual code. If we’ve done the design well, the cod¬ 
ing phase will be relatively easy because each of the methods identified in the design will be small. The fol¬ 
lowing is the entire program. 

// TwentyOnePickup.java 

import java.util.*; 

public class TwentyOnePickup { 

/ mgm JU 
ft /i 

* Play the game of Twenty-One Pickup. 

* The user and the computer take turns removing from 1 to 3 stones from 
* a pile. 

* There are 21 stones in the pile to start with. 

* The last one to remove a stone wins. 

V 

public static void main(String[] args) { 
printlnstructionsO ; 

// create the initial pile with 21 stones 
int numberOfStones = 21; 

// keep track of who moved last 
boolean piayerMovedLast = false; 
while (numberOfStones > 0) { 

numberOfStones - playerMove(numberOfStones); 
piayerMovedLast = true; 
if (numberOfStones > 0) { 

numberOfStones = computerMove(numberOfStones); 
piayerMovedLast = false; 

} 

} 
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// print the outcome 
if (playerMovedLast) 

System,out.println("Congratu1ations, you won."); 
el se 

System.out.println("Better luck next time."); 

} 


* printlnstructions prints the initial instructions 

*/ 

static void printlnstructionsQ { 

System.out.println( 

"The object of this game is to remove the last" 

+ " stone.\n" 

+ "There are 21 stones in the pile to start with.\n" 

+ "You may remove from 1 to 3 stones on each move.\n" 

+ "Good Luck!"); 

} 

/ JU «.»- 

* playerMove completes one move by the player. 

* ©param numberOfStones - The number of stones reamining in the pile. 

* ©return The number of stones remaining after the user’s move. 

V 

static int playerMove(int numberOfStones) { 
int move = getUserMove(numberOfStones); 
numberOfStones = numberOfStones - move; 

System.out.println("There are " + numberOfStones 4 " stones remaining."); 
return numberOfStones; 

} 

A 

* computerMove completes one move by the computer. 

* ©param numberOfStones - The number of stones reamining in the pile. 

* ©return The numberOfStones remaining after the computer's move. 

*/ 

static int computerMovefint numberOfStones) { 
int move; 

if (numberOfStones <= 3 ) { 

move = numberOfStones; /* remove the rest */ 

} 

else { 

move = numberOfStones % 4; 
if (move == 0) move = 1; 

} 

numberOfStones = numberOfStones - move; 

System.out.println("The computer removes " 4 move 
4 " stones leaving " 4 numberOfStones 4 "."); 
return numberOfStones; 
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* getUserMove reads in the user’s move, only accepting legal inputs. 

* ©param numberOfStones - The number of stones reamining in the pile. 
* ©return The number of stones selected for removal by the user. 

V 

static int getUserMove(int numberOfStones) { 

System.out.println("Your move - how many stones" + 

" do you wish to remove?"); 
int move = scan.nextlntO; 

while (move > numberOfStones || move < 1 If move > 3) { 
if (numberOfStones >= 3) 

System.out.println("Sorry," + 

" you can only remove 1 to 3 stones."); 

el se 

System.out.println("Sorry, you can only 

+ "remove 1 to " + numberOfStones + " stones."); 

System.out.println("How many stones" 

+ " do you wish to remove?"); 
move = scan.nextlntO; 

} 

return move; 

} 

static final Scanner scan = new Scanner(System.in); 


} 




Dissection of the TwentyOnePickup Program 


public static void main(String[] args) { 
printlnstructionsO; 

// create the initial pile with 21 stones 
int numberOfStones = 21; 

// keep track of who moved last 
boolean playerMovedLast = false; 

The method mai n () follows the top-level pseudocode presented in the design section. To keep mai n() 
short, we placed the statements to print the instructions in a separate method, 'he pile of stones is rep¬ 
resented by the integer numberOfStones, initially 21. During the implementation phase we discovered 
that we needed an additional variable, pi ayerMovedLast, to keep track of who moved last—the user or 
the computer. Without this variable, we didn’t know what message to print at the end of the program. 

H while (numberOfStones > 0) { 

numberOfStones = piayerMove(numberOfStones); 
playerMovedLast = true; 
if (numberOfStones > 0) { 

numberOfStones = computerMove(numberOfStones); 
playerMovedLast = false; 

} 

} 

This loop comes directly from the loop in the top-level pseudocode “while the game is not over.” The 
game is over when no more stones remain in the pile. Each time around the loop corresponds to one 
move by the user and one move by the computer, except possibly the last iteration when the computer 
doesn’t move. When the loop exits, we want to know whet tier the user or the computer moved last, hence 
the variable, pi ayerMovedLast. 
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# // print the outcome 
if (playerMovedLast) 

System.out.print!n("Congratulations, you won/'); 
else 

System.out.println("Better luck next time."); 

We could have created another method, pri ntOutcomeO, that contained these statements. Doing so 
would have made mai n() slightly shorter. We decided that this code was simple enough to leave it 
directly in main(). 

# static void printlnstructions() { 

System.out.println( 

"The object of this game is to remove the last" 

+ " stone.\n" 

+ "There are 21 stones in the pile to start with.\n" 

+ "You may remove from 1 to 3 stones on each move.\n" 

+ "Good Luck!"); 

} 

We could have placed the call to System. out. pri ntl n () that comprises the entire body of this method 
directly in mai n (). To keep mai n () short and free from unnecessary details, we decided to create this 
separate method. 

# static int playerMoveQ*nt numberOfStones) { 

int move = getUserMove(numberOfStones); 
numberOfStones = numberOfStones - move; 

System.out.println("There are " + numberOfStones + 

" stones remaining."); 
return numberOfStones; 

} 

The primary objective of the pi ayerMove() method is to remove some number of stones from the pile. 
Because Java uses call-by-value parameter passing, we can’t directly modify the variable numberOfS¬ 
tones created in the method mai n(). Instead we return the new value for numberOfStones and leave it 
to mai n() to store the returned value in the variable numberOfStones in mai n(). Note that the assign¬ 
ment to numberOfStones in the method playerMoveQ doesn’t change the value of numberOfStones in 
mai n (), which is a separate variable with the same name. We could replace every occurrence of the iden¬ 
tifier numberOfStones in playerMoveQ with some other identifier, such as numStones, and the pro¬ 
gram would work exactly the same. We used the same identifier in both mai n () and pi ayerMoveQ 
because to us it seemed like the most descriptive name. Also, it provided a perfect example of how scope 
allows the freedom to choose local variables without concern for name conflicts with local variables in 
other methods. 
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static int computerMove(int numberOfStones) { 
int move; 

if (numberOfStones <=3) { 

■ move = numberOfStones; /* remove the rest */ 

} 

else { 

move = numberOfStones % 4; 
if (move == 0) move = 1; 

} 

numberOfStones = numberOfStones - move; 

System.out.println("The computer removes " + move 
+ n stones leaving " + numberOfStones + "."); 
return numberOfStones; 


This method exposes the winning logic for the game. If three or fewer stones remain, of course the com¬ 
puter picks them all up, making it the winner. If more than three stones remain, the optimal move is to 
try to leave the pile with a number of stones that is a muliiple of four. If that isn’t possible, the computer 
removes just one stone. As with userMoveQ, compute rMove() returns the new number of stones in the 
pile as the result. 



+ 


static int getUserMove(int numberOfStones) { 

System.out.println("Your move - how many stones" 

" do you wish to remove?"); 
int move = scan.nextlnt(); 

while (move > numberOfStones || move < 1 I I move > 3){ 
if (numberOfStones >= 3) 

System.out.println("Sorry," + 

" you can only remove 1 to 3 stones."); 

el se 

System.out.println("Sorry, you can only " 

+ "remove 1 to " + numberOfStones + " stones 
System.out.pri ntln("How many stones" 

+ " do you wish to remove?"); 
move = scan.nextlntO; 

} 

return move; 

} 


it 


); 


A simpler version of this method could just call scan. nextlnt () and return whatever value it gets. This 
would work as long as the user always followed instructions and entered legal moves. As indicated dur¬ 
ing the design phase, we decided to try to make the program work even when the user makes a typing 
error. A good user interface allows the user to correct errors easily. The loop in this program will con¬ 
tinue to loop until the user enters a move that is less than or equal to the number of stones remaining in 
the pile and that also is between 1 and 3. We need two messages because if less than 3 stones remain, 2 
or 3 may not be a legal move, so we can’t always say “you can only remove 1 to 3 stones.” Even the ver¬ 
sion presented here is a bit clumsy if only one stone remains. In that case it will print the message, 
Sorry, you can only remove 1 to 1 stones. This problem can easily be remedied with a little more 
code. 


(> static final Scanner scan = new Scanner(System.in); 

The scanner must persist tliroughout the entier program. We declare it here as a global that cannot be 
reassigned as indicated by the keyword final. Although they are best avoided, sometimes it makes sense 
to create a variable that can be used anywhere in the program. The scope of this declaration of scan is 
the entire class. For more about such variables, properly called class variables, see Section 6.9, Static 
Fields and Methods , on page 169. 
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Here is the last part of the program output for one game. The values typed by the user are shown in boldface. 


There are 11 stones remaining. 

The computer removes 3 stones leaving 8. 

Your move - how many stones do you wish to remove? 

2 

There are 6 stones remaining. 

The computer removes 2 stones leaving 4. 

Your move - how many stones do you wish to remove? 

3 

There are 1 stones remaining. 

The computer removes 1 stones leaving 0. 

Better luck next time. 


Note that, once we let the computer get the edge, it will always adjust the pile to have a multiple of four 
stones, making winning hopeless for the user. 


4.9.4 TWENTY-ONE PICKUP: TESTING 


An in-depth discussion of testing is well beyond the scope of this book. Thorough testing is both difficult 
and Important. In general, you can’t possibly test every conceivable input. Even if you restricted your testing 
to consider that, for all but the last move, the user could enter a value that is too big, a value that is too small, 
or one of three legal values, you would have approximately 3000 test sequences to verify. Obviously, a more 
systematic approach to testing is necessary. 


One approach is called statement coverage . In this approach, you attempt to build a set of test cases such 
that when all test cases have been executed, each statement in the program has been executed at least once. 
If the set of tests causes every statement to be executed, the tests verify complete statement coverage. Unfor¬ 
tunately, complete statement coverage doesn’t guarantee that the program is correct. For example, if we 
made the following minor typing error in the whi 1 e condition in method getllserMoveQ, 


while (move > numberOfStones 


move < 0 


move > 3) 


verification of complete statement coverage might not uncover the error. To detect this error we would need 
to enter a move of 0 and then observe that this erroneous move was allowed. 


Another approach is called branch coverage. In this approach, you attempt to build a set of test cases such 
that, when all test cases have been executed, each possible branch has been taken at least once. Branch cov¬ 
erage isn’t quite the same as statement coverage. For example, statement coverage doesn’t require that a loop 
be forced to execute zero times, but branch coverage requires that the initial loop test be executed so that it 
branches both into the loop and around the loop. 

For the program TwentyOnePi ckup, we can begin by building a test set that provides complete statement 
coverage. We then need to add additional tests to verify that each of the relational expressions is correct. 
Here is an outline of our test strategy. 
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Test Strategy 

U All statements in mai n () will be executed if we include at least one case wherein the user wins 
(moves last) and one wherein the computer wins. 

# For computerMove(), all statements will be executed if we have a test case wherein the com¬ 
puter wins (the true branch of the outer i f~else statement) and a test case wherein the com¬ 
puter removes one stone because numberOf Stones % 4 is 0. In addition, we need a test case 
where numberOf Stones % 4 isn’t 0. 

• The method pi aye rMove () contains no branching statements, so any execution will cover all 
statements in the method. 

H For getUse rMove (), all statements will be executed if we provide at least one erroneous input 
value when more than three stones remain and one erroneous value when less than three stones 
remain. In addition, we need test cases that include a value that is too big and a value that is too 
small. We also need to test the end condition when less than three stones remain but the user 
enters 3. 

Thus t horough testing of even this simple program requires a significant number of test cases. 



4.10 RECURSION 


A method is said to be recursive if it calls itself, either directly or indirectly. In its simplest form the idea of 
recursion is straightforward. Try the following program. 

// Recur.java - recursive goodbye 
public class Recur { 

public static void main(String[] args) { 
sayGoodBye(5); 

} 

static void sayGoodBye(int n) { 
if (n < 1) //base case 

System.out.print1n("########"); 
else { 

System.out.println("Say goodbye Gracie."); 
sayGoodBye(n - 1); //recursion 

} 

} 


This program prints 


Say goodbye Gracie. 
Say goodbye Gracie. 
Say goodbye Gracie. 
Say goodbye Gracie. 
Say goodbye Gracie. 


######## 


The general form of a recursive method body is 
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if (stopping condition') //base case 

//do whatever at the end; 

else { //recursive case 

//execute recursive step 
RecursiveMethod(arguments) ; 

} 

A simple standard recursive method is factorial. 

static long factorial(int n) { 
if (n <= 1) 
return 1; 
el se 

return (n * factorial(n - 1)); 


Suppose that we executed x = factori al (4) ; inside method mai n(). The sequence of method calls would 
be 

mai n() cal 1 s factori al (4). 

factorial(4) calls factorial(3) . 
factorial(3) calls factorial(2). 
factorial(2) calls factorial(1). 

factorial(1) returns 1. 
factorial(2) returns 2. 
factorial(3) returns 6. 
factorial(4) returns 24. 
main() continues assigning 24 to x. 

When the innermost call, factori al (1), is executing, it is like having four different copies of the factorial 
method that have each been started but none have yet returned. Each has its own copy of the formal param¬ 
eter n, and each value of n is different. Recall that a formal parameter is like a local variable in that the scope 
is the body of the method. For this reason, the different versions of n don’t interfere with each other. 

The following table shows another view of factori al (4). First the base case is considered. Then working 
out from the base case, the other cases are considered. 


Method Call 

Value Returned 

factorial(1) 

1 


« 1 

factorial(2) 

2 * factorial(l) 

or 

2*1 = 2 

factorial(3) 

3 * factorial(2) 

or 

3*2*1 = 6 

factorial(4) 

4 * factorial(3) 

or 

4 *3*2*1 = 24 


Simple recursive methods follow a standard pattern. Typically, a base case is tested for upon entry to the 
method. Then there is a general recursive case in which one of the variables, often an integer, is passed as an 
argument in such a way as to ultimately lead to the base case. In factori al (), the variable n was reduced by 
1 each time until the base case with n equals 1 was reached. 

Most simple recursive methods can be easily rewritten as iterative methods, as in 

static long factorial(int n) { // iteratively 

int product = 1; 
for ( ; n > 1; --n) 
product = product * n; 
return product; 


} 
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For a given input value, both factorial methods return the same value, but the iterative version requires only 
one method call regardless of the value passed in. Method call is an expensive operation, so, in general, itera¬ 
tive versions of methods are more efficient than their recursive versions. 



4.11 PROBLEM SOLVING: MATHEMATICAL FUNCTIONS 


In science, we frequently have an equation that describes some behavior, such as Newton's law; F = MA, for 
force equals mass times acceleration. For complicated equations, we need to use computation to study their 
behavior. For example, we might want to visualize an equation. To do so we might graphically plot it or print 
a table of values for it (see Exercise 15 on page 117). 

One interesting property of a function is to find a zero of a function in a given region. We might try to find it 
by computing a function at many points in the interval and find the point f(x t ) = 0. Consider finding a 
root for the quadratic equation f(x) = x 2 - 2. This computation might be partly described as follows: 

// SimpleFindRoot.java - find the root of x*x - 2 
//Version 1.0 Won’t work- Why? 
class SimpleFindRoot { 

public static void main(String[] args) { 
double a = 0.0, b = 10.0, x, step = 0.001; 
x = a; /* start at one end */ 
while ( f(x) != 0.0 && x < b) { 
x = x + step; 

} 

if (x < b) 

System.out.println(" root is " + x); 
el se 

System.out.println(” root not found”); 

} 

static double f(double x){ return (x * x - 2.0);} 

} 

What’s wrong with this approach? Although we are examining the interval in fairly small steps, we might not 
hit a zero exactly. (Try the preceding code.) We might be more likely to identify a zero if we make locating a 
zero less precise. We leave modifying this code to choose the x so that f(x) is nearest to zero for you to do in 
Exercise 13 on page 117. This new scheme is guaranteed to find a solution, but it has two weaknesses. One, it 
is a brute-force approach and is computationally expensive. Second, it can fail because a smallest f(x) might 
not be near a true zero. 

A better method searches for a smallest interval that contains a zero, which is much safer numerically. This 
idea is based on the mean value theorem of calculus. Informally, when we plot a function on the x and y axes, 
keeping our pen on the paper, and on one side of the interval the function is above the x axis and on the 
other side of the interval the function is below the x axis, the pen must cross the x axis in that interval. In 
other words, for a continuous function, a zero exists in an interval (x, y) where f(x)f(y) < 0 . 

In our next method we make use of this observation. Further, we use the method of bisection to search the 
interval efficiently for a zero. This bisection problem-solving technique recurs in many areas of computer sci¬ 
ence. The idea is to check on the sign of the function evaluated in the center of the current interval and then 
to replace the existing search interval by one-half the size. We do so by replacing the relevant endpoint of the 
interval with the point just evaluated. For the code in this example, we assume that f(a) is negative and f(b) is 
positive for the initial interval endpoints, a and b. As shown in the figure, if the value of the function at the 
midpoint, f((a + b)/2 ), is negative, then the left endpoint, denoted by a , will be replaced with (a + b)/ 2 . 
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//FindRoot.java - use bisection to find a zero 
class FindRoot { 

public static void main(String[] args) { 
double a = 0.0, b = 10.0, eps = 0.00001; 
double root = 0.0 , residual; 
while ( b - a > eps ) { 
root = (a + b) / 2.0; 
residual = f(root); 
if (residual > 0) 

b = root; // replace right endpoint 

else 

a = root; // replace left endpoint 

} 

System.out.println(" root is " + root); 

} 

static double f(double x){ return (x * x - 2.0); } 

} 

Note that improvement in the accuracy of the interval is guaranteed for each evaluation. This improvement 
works out to a binary digit of accuracy. 



4.12 METHOD OVERLOADING 


In Section 4.3, The return statement , on page 84 we presented mi n () and max () methods that work with inte¬ 
ger values. If we want these methods to work with values of type doubl e, we must rewrite the methods. Here 
we rewrite mi n() and leave the rewriting of maxQ as an exercise. Instead of a and b, we use the parameters x 
and y, which is common practice when dealing with f 1 oats and doubl es: 


static double min(double x, double y) { 
if (x < y) 
return x; 
el se 

return y; 


Because Java supports method overloading, this definition of mi n () and the one from Section 4.3, The return 
statement, on page 85, that includes integer parameters can exist in the same class or program. These two 
definitions are distinguished by their signatures. A method signature is the name of the method along with 
the number and types of the parameters. Although not true for Java, some programming langagues also 
include the return type in the signature. For example, the two min() methods have differing signatures, 
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min(int, int) and min(double, double) 

When the Java compiler encounters a call to mi n(), such as mi n(exprl, expr2), the compiler can deter¬ 
mine which of the two mi n() methods to call, based on the types of the expressions, exprl and expr2. For 
example, if both expressions result in values of type i nt, then i nt mi n(i nt , i nt) would be called; if both 
are type doubl e, then doubl e mi n (doubl e, doubl e) would be called. This procedure, known as signature 
matching , is based on the types of the parameters for the method but not on the return type. This ability to 
define multiple methods with the same name is called method overloading. 

Overloading is an extremely useful feature. In languages without method overloading, programmers are fre¬ 
quently forced to choose contrived names for methods because another method with the preferred name 
already exists. Overloading is what makes it possible to call System.out. printlnQ with a Stri ng or any of 
the primitive types. Actually, different pri ntl n() methods exist for each of the different types. Without 
overloading, pri ntStri ng(), pri ntlntC), pri nt Doubl e(), and so on, would be needed. 

Returning to our example mi n (), what would happen if there was a call to mi n () with one i nt value and one 
doubl e value? The Java compiler would convert the i nt to a doubl e and call the version of minQ that takes 
doubl e parameters. In general, the compiler first tries to find an exact match. If if can’t find an exact match, 
then it performs widening primitive conversions to try to find a match. A widening primitive conversion is a 
conversion from one numeric type to another that is guaranteed to maintain the sign and most significant 
digits of the value being converted. For example, conversions from int to long or from int to float are 
widening primitive conversions. The former loses no information, and the latter may lose some significant 
digits; however, the most significant digits and the sign are preserved. For a detailed description of widening 
primitive conversion, see Section 2.10.2, Type Conversion , on page 32. 

Sometimes the conversions can result in more than one possible match. Multiple matches usually result in a 
compile-time error, and the call is said to be ambiguous , as in 

//AmbiguousOverload.java: won't compile 
class AmbiguousOverload { 

public static void main(String[] args) { 
int i = 1, ] = 2; 

System.out.println(ambig(i ,j)); 

} 

static boolean ambig(float x, int y){ 
return x < y; 

} 

static boolean ambig(int x, float y){ 
return x < y; 

} 

} 

An int can be converted to a f 1 oat by a widening primitive conversion. The ambiguity arises because we can 
either convert i and match the first definition of ambi g() or convert j and match the second definition. The 
definitions aren’t inherently ambiguous; it is the call that is ambiguous. If j was instead declared to be a 
float, then the ambiguity would be e limin ated and only the second definition would match the call. Explicit 
conversions, discussed in Section 2.10.2, Type Conversion , on page 32, can be used to resolve ambiguities 
such as this one. For example, changing the call to 

System.out.println(ambig((float)i, j)); 

would result in a call to the first version of ambi g (). 

Sometimes, widening conversions can lead to two matches but not be considered ambiguous. For example, 
suppose that signature Scall is the signature of the call and there are methods with signatures SI and S2. If 
Scall can be converted to SI using widening conversions and SI can also be converted to S2 using widening 
conversions, then SI is said to be more specific than S2. Visually the conversions looks like this. 
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Widening conversion 
Scall-SI 


Widening conversion 
-► S2 


In this case the method with signature SI, the more specific signature, will be called. Note that In the preced¬ 
ing example, Ambi guousOverl oad, neither of the two method signatures could be converted to the other by 
using widening conversions. In the following example, two matches can be found, but one is more specific 
than the other. 

//UnambiguousOverload.java: no ambiguity here 
class UnambiguousOverload { 

public static void main(String[] args) { 
int i = 1, j = 2; 

System.out.println(unAmbig(i,j)); 

} 

static boolean unAmbig(float x, float y){ 
return x < y; 

} 

static boolean unAmbig(double x, double y){ 
return x < y; 

} 


Although the call could be converted, using widening primitive conversions to match either of the methods, 
the method that takes two f 1 oat values is more specific and hence is the one called. 
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13 PROGRAMMING STYLE 


Breaking a problem into small subproblems that are then coded as methods is crucial to good programming 
style. To be easily readable, a method should be at most a page of code. Except for a few cases where the pur¬ 
pose of a method is trivially obvious from the choice of identifier names, methods should begin with an 
opening comment. In this book, however, we generally omit such comments because they would be redun¬ 


dant with the surrounding expository text. The opening comment should include a description of the input 
parameters and the return value. The parameter names should be chosen to identify clearly the purpose of 
the parameter. In some cases, well-chosen parameter names can eliminate the need for any further explana¬ 
tion. 


To encourage well-documented code, the standard Java tool set includes a program, javadoc, that can be 
used to create automatically HTML formatted documentation from stylized comments. Recall that HTML is 
the text formatting language for the World Wide Web. Here are sample javadoc comments for two of the 
methods for Coi nToss presented earlier in this chapter. Note the comments begin with /**. The strings 
beginning with @ are keywords in javadoc. There are more keywords for javadoc than the two used in this 
example. Consult the documentation with your system for additional details. 

public class CoinToss { 

/ s r - 

* Calculate the probability of throwing 4 heads in a row. 

* 10000 trials are run and the probability is estimated as the fraction 
* of trials that successfully tossed 4 heads in a row. 

V 

public static void main(String[] args) { 
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* Simulate an attempt to roll n heads in a row. 

* ©param numTosses The number of times to toss the coin. 

* ©return true if the next numTosses are all heads 

* false otherwise 

* / 

static boolean isAllHeads(int numTosses) 


Running javadoc on the source file CoinToss.java will generate a file CoinToss.html This file can be viewed 
with any browser. By default, javadoc generates documentation only for public classes and public methods. 
We discuss access modifiers and the keyword publ i c in Section 6.7, Access public and private: Data Hiding, 
on page 167. To get javadoc to generate documentation for classes and methods that don’t have an access 
modifier such as public, use the command 


javadoc -package CoinToss.java 

The flag -package is used because a method or class with no access modifier is said to have package access 
The following screen shot shows a portion of CoinToss.html viewed with Netscape. 
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public static void main (java. lang. String [] args) 

Calculate the probability of throwing 4 heads in a row. 10000 trials are run 
and the probability is estimated as the fraction of trials that successfully 
tossed 4 heads in a row. 
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isAllHeads 

static boolean isAUJteads (int numTosses) 

Simulate an attempt to roll n heads in a row. 

Parameters: 

numTosses - The number of times to toss the coin. 

Returns: 

true if the next numTosses are all heads false otherwise 
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Another stylistic choice is the order in which method definitions occur in a class. It is usually a matter of 
taste whether a programmer writes mai n () followed by the other method definitions, or vice versa. If a pro¬ 
grammer is doing top-down development, however, it is natural to start with mai n (). 


It is considered good programming style to have only a few return statements in a given method. In fact, the 
best choice is usually a single return as the last statement in the method. If there are many return state¬ 
ments, the logic of the code may be difficult to follow. 
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Summary 

# A simple program is made up of one or more static methods contained in a class, one of them being 
mai n(). In these simple cases, program execution begins with mai n(). When program control encoun¬ 
ters a method name followed by parentheses, the method is called, or invoked. This means that program 
control passes to the method. 

# Structured programming is a problem-solving strategy and a programming methodology 7 that strives for 
simple flow of control and involves the use of top-down design. .Also referred to as stepwise refinement, 
top-down design consists of repeatedly decomposing a problem into smaller problems. 

# The software life cycle generally includes requirements analysis and definition, design, implementation, 
testing, and maintenance. 

# A long program should be written as a collection of methods, each one being, in general, no longer than a 
page. Each method should cover some small task as part of the overall problem. 

# A variable declared in the body of a method is called a local variable. The scope of a variable begins at 
the point it is declared and continues to the end of the block cont ainin g the declaration. The scope of 
formal parameters is the entire method body. The scope of a variable declared in the initialization 
expression of a for statement is the entire for statement. 

# A programmer creates a method by writing a method definition, which consists of a header and a block, 
also known as the method body. The header consists of the type returned by the method, the method 
name, and a comma-separated list of declarations of parameters enclosed by parentheses. The body con¬ 
sists of a block of statements. 

# When a method is called, program control is passed to the method. When a return statement is executed 
or the end of the method is reached, control is passed back to the point of the call. If a return statement 
contains an expression, the value of the expression is also passed back to the point of the call. 

# In Java, all arguments of primitive types are passed call-by-value. That is, when a variable of primitive 
type is passed as an argument to a method, although the formal argument in the method can be 
changed, the value of the actual argument remains unchanged in the c allin g environment. 

# Java provides the method Math. randomO, for random doubles in the interval [0.0, 1.0). 

# A method that calls itself directly or indirectly is said to be recursive. Many progr ammin g problems can 
be solved with recursion, although an iterative solution is often more efficient. 

# Java methods can be overloaded. In other words, several methods can have the same name but with dif¬ 
ferent signatures. The signature includes the name of the method and the parameter types. 



Review Questions 

1. Within a class, is the order of method definitions important? Why or why not? 

2. True or false? When passing parameters, the name of the actual parameter must match the name of the 
formal parameter. 

3. What is the significance of voi d in the following statement? 
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public static void printMessageQ 

4. Give an example of method overloading. 

5. What is the output of the following program? 

class PracticeProblem { 

public static void main (String[] args) { 
int x = 10, y = 5; 
printProduct(x, y); 
x = 2; 

printProduct(x + y, x); 

} 

static void printProduct(int x,int y) { 

System.out. pri nt("The Product of " + x) ; 

System.out.print( u and " + y + " is "); 

System.out.println(x * y); 

} 

} 

6. A method definition must always specify what important aspect of each formal parameter? 

7. Where do you specify the type of expression that must follow the keyword return? 

8. Does writing a method that has several hundred lines of code in its definition violate top-down program¬ 
ming? Explain. 

9. The expression (i nt) (n * Math. randomO) % 10 generates integers in what range? 

10. What is printed by the following program? 
class Fen { 

static int foo(int a, int b) { return (a + b); } 
static int goo(int x) { return (x * x); } 
public static void main(String[] args) { 
int i =2; 

System.out.println(”foo = " + foo(i, 3)); 

System.out.println("foo = " + foo(i, 4)); 

System.out.println(”goo = " + goo(i)); 

System.out.println("goo = " + foo(goo(i), i++)); 

} 

} 

11. What are two static methods you have used from the Java libraries? 

12. The javadoc program is used for what? When using it, why should you use the comment style /** 
Remember Me? */? 


13. What syntax errors are in the following program? 
class Scope { 

public static void main(String[] args) { 
int x = 1; 

{ 

int x = 2; 
int y - 3; 
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System.out.printlnC'x = " + x) ; 

System.out.printlnC'y = " + y); 

} 

System.out.println("x = " + x); 

System.out.printlnC'y = " + y) ; 

} 

} 

14. Which step of the software Life cycle is often the longest and most costly? 

15. Name two different approaches to software testing. 

16. What is printed by the following program? 

class RecursionExercise { 

public static void main(String[] args) { 
for (int i =0; i <10; i++) 

System.out.println(recurse(i)); 

} 

static long recurse(long n) { 
if (n <~ 0) 
return 1; 
el se 

return 2 * recurse(n -1); 

} 

} 



Exercises 


1. Rewrite the class Message in Section 4.1, Method Invocation , on page 82 so that it prints out a personal¬ 
ized happy birthday greeting. 

Message for FILLIN: Happy Birthday to you! 

You are XX years old! 

Have a nice year! 

Be sure that it handles the special case of a one-year-old, printing You are 1 year old! 

2. Rewrite the class Message2 in Section 4.2, Static Method Definitions, on page 83 to read from the key¬ 
board the value n that will be passed to the method pri ntMessageC). 

3. Write a static method squareQ that will take an integer and return its square and a static method 
cubeO that will take an integer and return its cube. Use your square () and cube() methods to write 
the methods quarti c() and qui nti c() that return the fourth and fifth power of an integer, respec¬ 
tively. Use your methods to write a program that prints a table of powers of integers from 1 to 25. The 
output of your program should look like 
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A TABLE 

OF POWERS 


Integer 

Square 

Cube 

Quartic Quintic 

1 

1 

1 

1 1 

2 

4 

8 

16 32 


4. Write the method static double max (double x, double y). This method can be defined in the same 
class as stati c i nt max(i nt x, i nt y) because the argument types of the two methods are different. 

5. Modify i sAl 1 Heads () to compute the probability using an unfair coin that comes up heads with proba¬ 
bility 0.8. How do fair and unfair coins compare for producing five heads In a row? If you know the prob¬ 
ability theory for this case, work it out theoretically. Does the theoretical result agree with your 
computational experiments? 

6. Modify isAll Heads() to compute almostAl 1 Heads(i nt n, int k), which is true if at least k out of n 
heads are tossed. Test it by computing the probability that you would toss at least 6 of 10 heads. 

7. Modify the coin toss simulation to compute the probability that you get 5 of 10 heads exactly. 

8. Modify Exercise 14 on page 77 in Chapter 3, to have a method drawBox () that takes the width and height 
of the box in asterisks as formal parameters. Modify the program further to include three methods: 
drawLineO, drawSidesQ, and drawBoxQ. The method drawLineQ will take two parameters: the 
length of the line and a Stri ng that will the method will print length times to draw the line. The method 
d rawSi des () will take three parameters: the height of the sides, the width of the box that will be formed 
(both lines must be drawn at the same time), and a Stri ng used to represent a side. The method draw- 
Box() will take three parameters: the width and height of the box and a string used to represent the 
sides. For example, if called as drawBox (5,4, "Java"), the output would be 


3ava 3 avaj avaj ava 3 ava 
java java 
java java 
j avaj avaJavaJava3ava 


9. Write a weather prediction program using the random number generator. Three outcomes should be pos¬ 
sible: rain, sun, or cloudy. Assume that each outcome occurs one-third of the time. 

10. Write a fortune-telling program, using the random number generator to pick 1 of at least 10 fortunes. 
Use the swi tch statement in the following way. 

switch((int)(10 * Math.random()) { 
case 0: ... break; 
case 1: ... break; 

//more cases with fortunes 
case 9: ... break; 

} 

2 

11. Write a program to print the values of F(x) = x - 2 for the range 0 < x < 10. Print the values in this 
range at a step size of 0.01. Also find the largest and smallest value of F(x) in this interval. 

12. Modify SimpleFindRoot to find x, such that F[x) is nearest to zero. You can use the static method 
Math. abs () to solve this problem. 
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13. Modify Fi ndRoot to solve for a root of F(x) = e - 10. Use as your starting interval (0, 5). How do we 
know tins interval will work? (The answer can be found in Section 4.11, Problem Solving: Mathematical 
Functions , on page 108.) The class java. 1 ang.Math has a method Math. pow(doubl e nl, doubl e n2) 
that computes nl raised to the n2 power. The class also defines the constant Math . E. 


14. A further method for finding roots employs a Monte Carlo search. A random point in the search interval 
is chosen. The function is evaluated at this point. If the result is closer to zero than the value of the func¬ 
tion for any previous point, then this point is kept as the current candidate solution. The more points 
evaluated, the greater becomes the confidence in the final solution. This approach is similar to Si mpl e- 
Fi ndRoot and is a brute force, computationally expensive method. It avoids some subtle problems 
because it chooses its candidate points at random. Write such a method and use 100 points in the inter- 
val 0 through 5 to solve for a root ofF(x) = e x - 10. Now try the method with successively 100 and 
10,000 points. Observe how slowly the accuracy of the root improves compared to that of the bisection 
method. 


15. Write a program that allows the user to play the game of Craps, which is played with two dice. A simple 
version of the game between one player and “the house” can be described as follows. 


Pseudocode for Dice 

1. The player bets some amount of money. 

2. The player throws the dice. 

3. If the dice total 2 or 12 the player loses the bet and play starts again at 
step 1. 

4. If the dice total 7 or 11 the player wins the amount of the bet from the 
house and play starts again at step 1. 

5. If the dice total any other value, this value is called the point. 

6. The player continues to roll the dice until they total either 7 or the point. 

7. If the dice total is 7 the player loses the bet; otherwise, the player has 
made the point and wins the amount of the bet from the house. In either case, 
play starts again at step 1. 


Play continues until the player indicates that he or she wants to quit or until the player runs out of 
money. Before you begin to write the code for this program, you should develop a design. Convert the 
description of play to pseudocode and identify the primary methods that you’ll need. You may even need 
to refine the specification some more first. For example, how much money does the player start with? To 
simulate the roll of the dice, the expression 

(i nt) (Math. randomQ * 6) + 1 

will evaluate to a random integer of 1 through 6. You must simulate rolling each die separately. Generat¬ 
ing a random number in the range 2 through 12 isn’t sufficient. 

16. Write and test a method that will recursively print all the characters from 1 a' through ' z'. Remember 
that each character is one more than the previous. 

17. Write and test a method that recursively prints the characters from f i rst through 1 ast: 

static void printRange(char first, char last) 

//example if first = ' c' and last = 1 g’ then 
//prints c d e f g 

(Hint: recur on the variable fi rst.) 

18. Fibonacci Recursion. Many algorithms have both iterative and recursive formulations. Typically, recur¬ 
sion is more elegant and requires fewer variables then does iteration to make the same calculation. 
Reciusion takes care of its bookkeeping by stacking arguments and variables for each invocation. This 
stacking of arguments, although invisible to the user, is still costly in time and space. Let’s investigate 
efficiency with respect to the calculation of the Fibonacci sequence, which is defined recursively by 
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fo - 0, fi - 1, 

fi+i = fi + 4-1 for i= 1, 2, ... 

Except for f 0 and ft, every element in the sequence is the sum of the previous two elements. The 
sequence begins 0, 1, 1, 2, 3, 5, ... Here is a function that computes Fibonacci numbers recursively: 

static long fibonacci(int n) { 
if (n <= i) 
return n; 
el se 

• return (fibonacci(n - 1) + fibonacci(n - 2)); 

} 

Write a class that tests this recursive calculation. Choose a large enough n, say, n = 40, to see the results 
of the computation on the screen where the calculation visibly slows. It begins to slow in the range n > 35 
on a 400 megahertz Pentium. 

Now write an iterative version of this same algorithm and run it up to the same n or larger. It should run 
instantaneously. Explain why. 



Applet Exercise 


In the Applet Exercise at the end of Chapter 2, Program Fundamentals , you explored how to do simple draw¬ 
ing using an applet. Methods let you easily create more complicated drawings. For example, the standard java 
method drawOval () from the class Graphi cs can draw an oval of any size, placed anywhere on the visible 
area of an applet. By creating methods to draw a shape with its size and position controlled by parameters, 
you can make complicated drawings much more simply. The following applet uses the standard Java method 
fi 11 Rect() from the class Graphi cs to draw a simple chair. 

/* <applet code=”DrawChai rs. class" width=150 height=120x/applet> */ 
import java.awt.*; 
import javax.swing.*; 

public class DrawChairs extends JApplet { 
public void paint(Graphics g) { 
drawChair(10, 10, 50, 100, g); 
drawChair(70, 10, 25, 50, g); 
drawChair(105, 10, 10, 20, g); 

} 


* drawChair draws a chair at the specified position, 

* scaled to the specified size 

* @param left The distance in from the left edge. 

* @param top The distance down from the top. 

* @param width The width of the chair seat. 

* @param height The height of the chair back. 

* @param Graphics The object to draw on. 

*/ 

void drawChair(int left, int top, int width, int height, Graphics g) { 

// thickness of the legs, back and seat 
int thickness = width / 10 + 1; 

// draw the seat 

g.fi 1 lRect(left, top + height / 2, width, thickness); 
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// draw the back and back leg 

g.fillRect(left + width - thickness, top, thickness, height); 

// draw the front leg 

g.fi11Rect(left, top + height /2 , thickness, height / 2); 

} 

} 




Dissection of the DrawChairs Applet 


# /* <applet code="DrawChai rs.class” width=150 height=120x/applet> */ 
import java.awt.*; 

import java.applet.*; 

public class DrawChairs extends JApplet { 

As with the applet exercises in previous chapters, this code is just part of the template. We explain the 
details later in Chapter 8, and Chapter 9, Graphical User Interfaces: Part II. For your own applets, you 
need only change the name of the applet DrawChai rs to something appropriate. Be sure and change 
both occurrences of DrawChai rs in the template. Also, you may decide to change the width and height 
of your applet, t alike the applet In Chapter 3, on page 78, this applet doesn’t respond to user input, so 
you don’t need import java, event .* and implements Act ion Li stener as you did in that earlier exer¬ 
cise. 

# public void paint(Graphics g) { 

drawChair(10, 10, 50, 100, g); 
drawChair(70, 10, 25, 50, g); 
drawChair(105, 10, 10, 20, g); 

} 

This method is called when it is time for the applet to be displayed. For this particular applet, this is the 
top-ievel method, which is somewhat like mai n() in other programs. Here we call our new method 
drawChai r () three times, drawing three different-sized chairs in three different locations. Here is what 
it looks like when executed. 



• void drawChair(int left, int top, int width, int height, Graphics g) 

Our method drawChai r () takes the same four parameters as drawOval (): the coordinates of the upper 
left corner and the width and the height of an imaginary box drawn around the chair. In addition, our 
drawChai r () method must be passed the Graphi cs object upon which the drawing is to be made. 
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# int thickness = width / 10 + 1; 

To make our chair scale properly, we set the thickness of the chair seat, legs, and back to be about 10 
percent of the overall width of the chair. The +1 ensures that the thickness is always at least 1. Recall 
that, if wi dth is less than 10, then the expression wi dth / 10 will be 0. 

# // draw the seat 

g.fillRect(left, top + height/2, width, thickness); 

// draw the back and back leg 

g.fillRect(left + width - thickness, top, thickness, height); 

// draw the front leg 

g.fillRect(left, top + height / 2, thickness, height / 2); 


The method f i 11 Rect () draws a filled-in rectangle. The parameters for f i 11 Rect () are the same as the 
parameters for drawOval (), namely, the coordinates of the upper left comer of the rectangle, the width, 
and the height. You can also draw an outline of a rectangle with the method drawRectQ and a filled-in 
oval with f i 11 Oval (). The following drawing shows the relationships of the various values used to draw 
the chair 
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Modify the applet DrawChai rs to include methods similar to drawChai r () that draw a table and a vase. Your 
methods have to allow the shapes to be drawn anywhere and at any size. Each shape should be placed inside 
an imaginary box. Then use your methods to draw a picture that includes at least two tables, two chairs, and 
two vases, each a different size. You should first work out your drawing on paper with a figure like the one 
above for the chair. 
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5.1 


ONE-DIMENSIONAL 


data 


ARRAYS 


So far we’ve been dealing with distinct variables for referring to any particular stored value. However, there 
are many collections of similar values in everyday situations—for example, students’ test scores or the social 
security numbers of employees. An array in Java is a data structure that stores and processes such related 
values. An array is a container that holds a related group of values of the same type. For example, you can 
use an array of integers to represent student test scores. In addition to a built in array type, Java’s library 
also has a large number of standard containers, such as ArrayList and Vector. 


In Java, the elements in an array are always numbered 0 through n - 1 where n is the number of individual 
items or elements in the array. The elements in an array are ordered, and the position of an element in the 
array is called the element’s index. The main reason for starting at 0 is to make Java arrays follow the same 
convention as that of C and C++. Arrays of values are arranged in contiguous memory locations. The name of 
the array is viewed as referring to the first element in the array. To find the address in memory of a specific 
element, the computer can add the element’s index to the address of the location of the first element. The 


following figure shows an array of seven integers having the values 
referred to by the variable data. 


100 through 106. The array is being 
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The variable data tells the computer where the first element In the array is located (Indicated by the arrow). 
To find the value at index 3 in the array the computer locates the first element and then moves down three 
locations. In this case the element at index 3 is 103. 

You declare array variables by specifying a type followed by the name of the variable. For any type T in Java, 
T[] is the notation for the type: array of Ts. Some examples of array variable declarations are 

int[] data; //reference to array of ints 

Stringf] sentence; //reference to array of Strings 

These are reference declarations. As the preceding figure suggests, it contains a reference or pointer to the 
actual array data. All variables in Java are either primitive type variables or reference variables. Reference 
variables are declared with a class type or are declared with an array type. No actual arrays are created by the 
declarations shown. Arrays are created by using the operator new. The general syntax for creating an actual 
array and assi gnin g an array variable to refer to the newly created array is 

someArrayVariable = new type [ length ] ; 

Execution of this statement will evaluate length, an integer expression, and then create an array with length 
elements of type type. The array variable someArrayVariable is assigned to reference this newly created array 
object. For example, let’s assume that we use v = new i nt [n] to allocate an array v. After this statement has 
been executed, the i nt variables v[0], v[l], v[2],..., v[n - 1] come into existence and can be used 
by the program. Once an array has been created, its size may not be changed. However, an array variable may 
be changed to refer to a different array that is a different size (see Section 5.4, Array Assignment, on page 
127). 

Here are some more examples. 

data = new int[7]; // 7 int’s 

sentence = new String[2 * n]; // 2n Strings 

In the same way that other variables can be declared and assigned initial values in one statement, array vari¬ 
ables can be declared and assigned initial values in one statement, as in 

int[] data = new int[100]; 

String[] names = new String[1000]; 


5 . 1.1 INDEXING AN ARRAY ELEMENT 

To manipulate each individual element we use subscripting or indexing. Let’s assume that declarations of the 
form 

int[] someArray = new int [length] ; 
int i; //used to index or subscript array 

have been made. Then we can write someArray [1 ] to access an element of the array. More generally, to 
access an element of the array we may write someArray [ expr ], where expr is an integral expression. We call 
expr a subscript, or index, of someArray. The value of a Java subscript should he in the range 0 through 
length - 1 , where length is the number of elements in the array. 


5.1.2 ARRAY INITIALIZATION 

Arrays have their individual elements automatically initialized when allocated. Primitive numeric types are 
initializer! to 0, and the type bool ean is initialized to fal se. All other types are reference types and are ini¬ 
tialized to the special value null, which signifies that the element doesn’t currently refer to any tiling. Once 
an array has been created, we can assign specific element values using assignment, as in 
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int[] a = new int[2]; //create a[0] = a[l] - 0 
a[0] = 10; //a[0] now has integer value 10 

a[1] = 20; //a[l] now has integer value 20 

For convenience, Java provides a way to declare, create, and initialize an array in one statement. Arrays can 
be initialized by a comma-separated list of expressions enclosed in braces. The compiler uses the number of 
expressions as the size for the array. Hence we can more succinctly declare and initialize the preceding 
assignments as 

int[] a = (10, 20}; //allocates and initializes 

The following simple program initializes an array, prints its values, and computes its sum and average value. 

// ArraySum.java - sum the elements in an array and 
// compute their average 
class ArraySum { 

public static void main(String[] args) { 
int[] data = {11, 12, 13, 14, 15, 16, 17}; 
int sum = 0; 
double average; 
for (int i =0; i <7; i++) { 
sum = sum + data[i]; 

System.out.print(data[i] + ", ”); 

} 

average = sum / 7.0; 

System.out.printf("\n\n sum = %d average = %f\n”,sum, average); 

} 

} 




Dissection of the ArraySum Program 

# int[] data = {11, 12, 13, 14, 15, 16, 17}; 

The variable data is declared to refer to an array of integers. It is allocated seven integer elements, 
which are initialized to the values 11 through 17. 

# for (int i =0; i <7; i++) { 

The for statement declares the local variable i to be used as an index or subscript variable. This for 
statement is the most common array code idiom. The initial subscript for array objects in Java is 0, so 
the subscript variable is usually initialized to 0. The array length is 7, so the terminating condition is 
usually i < 7 so that the loop will stop after executing the loop body with the array index set to 7 - 1. 
The last part of the for statement header is the increment of the index variable, ensuring that each array 
element gets processed in turn. 

# sum = sum + data[i]; 

System.out.print(data[i] + ", "); 

The element data[i ] is selected by computation of the index value. A common error that results is for 
the index value to be out of range. These subscripted or indexed elements can be used as simple vari¬ 
ables of type i nt. In this code, each element’s integer value is added to the variable sum. Then, in turn, 
each element’s value is printed. 



The output of this program is 
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11, 12, 13, 14, 15, 16, 17, 
sum = 98 average = 14.0 


5.1.3 ARRAY MEMBER LENGTH 

Once created, an array stores more than just the elements of the array. The most Important extra informa¬ 
tion now is the length of the array. The expression arrayVariable. 1 ength can be used to determine the num¬ 
ber of elements allocated to an array. It will be an Integer value greater than or equal to 0. A common use of 
the length member for an array is in a for statement header. Using arrayVariableA ength is preferable to 
coding a particular integer constant or other expression. In the class ArraySum, the for statement should be 
rewritten as 

for (int i =0; i < data.length; i++) { 
sum = sum + data[i]; 

System.out.print(data[i] + ", "); 

} 

which is our preferred style. It is less error prone than writing an explicit integer or specific integer expres¬ 
sion. If we insert additional elements in the array initialization, no other changes are needed. 


Common Programming Error 


An array subscript value outside the range 0 through length - 1 will cause the program to abort with an 
error message about an IndexOutOfBoundsException. When that happens, the condition is called 
“overrunning the bounds of the array” or “subscript out of bounds.” In Chapter 11, Coping with Errors 
we discuss how programs can catch these errors at run time and attempt to recover. Java, unlike some 
other popular progr ammin g languages, is much easier to debug because this common error is caught by 
the system, which displays an informative message. 


common error that is more difficult to detect is to begin or end the array computation with the wrong 
element. It is sometimes called the “off-by-one error,” The following code shows this error. 


for (int i = 1; i < data.length; i++) 

sum = sum + data[i]; //forgot to start with i=0 



5.2 THE FOR ITERATOR STATEMENT 


Java 1.5 comes with an iterator statement. An iterator is a device that automatically traverses and retrieves 
each element value of a container, such as an array. This is a very important methodological improvement to 
the language, because it avoids many common program errors when processing arrays and other containers. 

The syntax of the iterator statement is: 

for ( Type Identifier : Iterable Expression ) 
statement 

An iterable-expression can be an array name, or as we shall see, other container names that conform to the 
interface java,lang.Iterable. 
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5.3 Passing Arrays to Methods 

Here is a simple use replacing the for loop In the previous code example, 
for (int d : data) { 

sum = sum + d; //replaces data[i] with d 
System.out.print(d + ", "); 


Note, that without Indexing it is not possible to make an indexing error. However this construct is not as flex¬ 
ible as the usual for loop with indexing. First, we cannot readily or efficiently do a subset of indexing, such as 
looking at the even indexed elements. Second, we cannot mutate the elements of the container. These restric¬ 
tions still leave this a very powerful construct. 



5.3 PASSING ARRAYS TO METHODS 


In the previous section, we had code that s umm ed the integer array data in mai n (). This standard action is 
better packaged as a method so that it can be generally reused. The following program contains a method 
sum() to compute the sum of the elements in an array of integers. 

// ArraySum2.java - sum the elements in an array 
// using a method 
class ArraySum2 { 

public static void main(String[] args) { 
int[] datal = {1, 2, 3, 4, 5, 6, 7}; 
int[] data2 - {16, 18, 77}; 

System.out.println("datal:" + sum(datal)); 

System.out.println("data2:" + sum(data2)); 


// sum the elements in an array 
static int sum (int[] a) { 
int sum = 0; 
for (int d: a) 
sum = sum + d; 
return sum; 

} 

} 

The output of this program is 


data: 28 
data2:111 


The length field of each array allows the sum() code to index properly each array. In the first invocation, 
sum (datal), the seven array elements of datal are s umm ed. In the second invocation, sum(data2), the 
method sums the three elements of data2. 

As discussed in Section 4.8, Invocation and CaU-By-Value , on page 96, Java passes parameters by value. Recall 
that arrays are reference types. Thus, although you may casually think of the value of an array such as datal 
in the preceding example, as the entire array of values, in fact the “value” of the variable datal is simply a 
reference to the array of values. So t hink of the array variable as storing the address of the actual array data. 
This address, not the array data, is passed by value when an array is passed to a method. 

One of the reasons for this style of parameter passing with arrays is that arrays are often very 7 large. Passing 
references to the array instead of the entire array of values enables programs to execute much faster. Each 
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rimp an array is passed as a parameter, all the data values in the array need not be copied into the method— 
only the address of the array is copied. 

An Important consequence of the fact that array references, not the entire array of values, are passed is that 
we can pass an array variable to a method and have the method modify the contents of the array. Tltis result 
is called a side effect because a side effect of calling the method is that the array’s contents are changed. The 
following program contains a method for copying the values of one array into another array. 

// TestCopy.java - demonstrate that array 
// parameters can be modified 
class TestCopy { 

public static void main(String[] args) 


int[] datal = {1, 2, 3, 4, 5, 6, 
int[] data2 = {8, 9, 10, 11, 12, 
copy(datal, data2); 

System.out.println("datal:; 
for (int d: datal) 

System.out.println(d); 

System.out.println("data2:; 
for (int d: data2) 

System.out.println(d); 

} 

static void copy(int[] from, int[] 
for (int i = 0; i < from.length; 
to[i] = from[i]; //mutates so 

} 


7}; 

13, 


{ 

14}; 


to) { 

i +4*) 

we use 


indexing 


} 


The call to copy () changes the integer values stored in the elements of the array data2. The elements of the 
array to inside copyO are mutable or changeable. Recall that a primitive type variable, when passed as a 
parameter, can’t be changed by the called method, although the copy in the called method can be changed. In 
contrast, use of an array reference parameter can lead to changes in array element values in the calling envi¬ 
ronment. When a parameter, such as the second parameter to copyO, is used to pass information back to 
the calling environment, the parameter is called an output parameter. It is so called because the parameter is 
used to send information from the method. This action is shown graphically in the following illustration. The 
arrows indicate that the array variables are referring to array objects. Although not shown, each array object 
contains the length of the array, followed by the elements of the array. When the method copyO is called, 
the values in the boxes labeled datal and data2 are copied into the boxes labeled from and to. Recall also 
that the value is the reference to the array, not the array of values. The crossed out values show how the old 
element values in data2 or to (both refer to the same array of values) are replaced during the execution of 
the body of method copy(). 


mai n() 


copyO 
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Common Programming Error 

As with other variables, direct modification of an array parameter has no effect at the point of the call. 
To demonstrate this lack of effect, let’s suppose that the following method was substituted for the 
copyC) in the class TestCopy. 

static void copy(int[] from, int[] to) { 

to = from; // failed attempt to copy an array 

} a,.. . i j 

Using this method, as the comment suggests, wouldn’t perform the desired copy operation. In fact, call¬ 
ing the latter copy () method would have no effect outside the method. Nor would the arrays datal and 
data2 in mai n() be affected. The result of calling the defective copy() method is shown in the following 
diagram. It represents the state of the computer’s memory after the assignment statement to = from in 
copy(). 


mainC) copyQ 



As shown, the variable to is made to refer to the array referred to by the variable from and datal, but 
no change is made to the contents of either array or to data2. 



5.4 ARRAY ASSIGNMENT 


Although we can’t change the size of an array once it has been allocated, we can assign one array to another. 
The failed copy () method in the previous section assigned one array variable to another in to = from. If the 
array referred to by from wasn’t the same size as the one originally referred to by to, then we could say the 
size of to had been changed. Consider the following code excerpt. 

int[] al = {10, 20, 30}; //3 element array 

int[] a2 = {1, 2, 3, 4, 5}; //5 element array 

al = a2; //now both refer to the same 5 elements 

Note that this code fragment makes the arrays al and a2 physically the same array; al[0] is in the same 
location in the computer’s memory as a2 [0], and changing one will change the other. If instead you want to 
create a new array from an old array, you need to allocate a new array and assign each element from one 
array to the other. The following method could be used to duplicate a one-dimensional array of integers. 
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static int[] duplicatednt[] a) { 
int[] theCopy = new int[a.length]; 
for (int i = 0; i < a.length; i++) 
theCopy[i] - a[i]; 
return theCopy; 

} 

The following statement could be used to make a duplicate of the array a2. Let’s assume that al and a2 were 
declared as previously shown. 

al = duplicate(a2); //now two arrays containing 1 to 5 

For one-dimensional arrays, a built-in mechanism produces an identical copy of an array. A method cl one() 
is defined for all arrays so that 

al = (int[])a2.clone(); // built in array "copy" 
has the same effect as the use of duplicated). 



5.5 FINDING THE MINIMUM AND MAXIMUM OF AN ARRAY 


We can use the following program to illustrate some of these ideas. The program reads in an array of values, 
prints out the values, and finds the minimum and maximum elements. 

// ArrayTest.java - minimum and maximum of an array 
import java.util 
class ArrayTest { 

public static void main(String[] args) { 
int[] data; 
int n; 

Scanner scan = new Scanner(System.in); 

System.out.println(”Enter size of data[]:"); 
n = scan. nextlntO ; 
data = new int[n]; 

System.out.println("Enter " + n + " integers:"); 

readArray(data, scan); 

printArray(data, "My Data"); 

System.out.println("minimum is " + minimum(data) + 

" maximum is " + maximum(data)); 

} 

// fill an array by reading values from the console 
static void readArray(int[] a, Scanner scan) { 
for ( int i =0; i < a.length; i++) { 
a[i] = scan.nextlntO ; 

} 

} 

// find the maximum value in an array 
static int maximum(int[] a) { 

int max = a[0]; //initial max value 
for (int d : a) 
if (d > max) 
max = d; 
return max; 


} 
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// find the minimum value in an array 
static int minimum(int[] a) { 

int min = a[0]; //initial min value 

for (int d : a) 
if (d < min) 
mi n = d; 
return min; 


// print the elements of an array to the console 
static void printArray(int[] a, String arrayName) { 

System.out.println(arrayName ); 
for (int d : a) 

System.out.print(d + " "); 

System.out.printlnO ; 

} 

} 

Note that this program contains a series of useful methods, all of which are applicable to the basic container 
class, integer array. The code also shows the power of the various for statements as an iterator mechanism 
for traversing the array container, processing each element in turn. 



Dissection of the ArrayTest Program 


• int[] data; 
i nt n; 

Scanner scan = new Scanner(System.in); 

System.out.println( H Enter size of data[]: M ); 
n = scan.nextlnt(); 
data = new int[n]; 

The array reference variable data is initially null. We dynamically create the array based on user input, 
namely, the input assigned to n. 

% static int maximum(int[] a) { 

int max = a[0]; //initial max value 
for (int d : a) 
if (d > max) 
max = d; 
return max; 

} 

The maximum value is found by a linear search of the array. One element at a time is tested to determine 
whether it improves on the maximum value. A single for iterator statement processes the entire array. 
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5.6 A SIMPLE SORTING METHOD 


Sorting is a very useful problem-solving technique. The question of how to sort information efficiently is an 
important area oi computer science theory and practice. Efficient sorting algorithms typically require 
approximately n login) comparisons to sort an array with n elements. The selection sort, presented below, is 
inefficient because it requires rr comparisons; nonetheless, for small arrays its performance is usually okay. 

// SelectionSort.java - sort an array of integers 
class SelectionSort { 

public static void main(String[] args) { 
int[] a = {7, 3, 66, 3, -5, 22, -77, 2}; 
sort(a); 

for (int d : a){ 

System.out.println(d); 

} 

} 

// sort using the selection sort algorithm 
static void sort(int[] data) { 
int next, indexOfNext; 

for (next = 0; next < data.length - 1; next++) { 
indexOfNext = min(data,next,data.length - 1); 
swap(data, indexOfNext, next); 

} 

} 

// find the index of the smallest element in 
// a specified range of indices in an array 
static int min(int[] data, int start, int end) { 
int indexOfMin = start; // initial guess 
for (int i = start+1; i <= end; i++) 
if (data[i] < data[indexOfMin]) 

indexOfMin = i; // found a smaller value 
return indexOfMin; 

} 

// swap two entries in an array 

static void swap(int[] data, int first, int second)! 
int temp; 

temp = data[first]; 
data[first] = data[second]; 
data[second] = temp; 

} 


} 
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Dissection of the SelectionSort Program 


• public static void main(String[] args) { 

int[] a - {7, 3, 66, 3, -5, 22, -77, 2}; 
sort(a); 

for (int d : a){ 

System.out.printl n(d); 

} 

} 

This program creates a sample array, passes the array to the method sort (), and then prints the array. 
Before the call to sort (), the values in the array are clearly not in increasing numerical order. After the 
call to so rt () the values in the array will be in increasing numerical order. 

• static void sort(int[] data) { 

int next, indexOfNext; 

for (next = 0; next < data.length - 1; next++) { 
indexOfNext = min(data,next,data.1ength - 1); 
swap(data, indexOfNext, next); 

} 

} 

This method does the actual sort. It is called a selection sort because the algorithm first finds the small¬ 
est value in the array, selects it, and puts it in its proper position. The algorithm then selects the smallest 
value of those remaining and so on until all values have been selected. Each iteration of the for loop 
selects the smallest value of the remaining values—those with indices between next and 
data. 1 ength - 1. The first iteration selects the smallest value from the entire array because next will 
be 0. We have written a method, mi n(), to do the work of finding the index of the smallest element over 
a range of indices. The method swapQ moves the selected element, the one with index i ndexOfNext, 
into its proper position, next, by swapping it with whichever element is currently next. The operation of 
sort () is illustrated for the data in this program, following this dissection of Sel ecti onSort. 

• static int min(int[] data, int start, int end) { 

int indexOfMin = start; // initial guess 

for (int i = start + 1; i <= end; i++) 
if (data[i] < datafindexOfMin]) 

indexOfMin = i; // found a smaller value 
return indexOfMin; 

} 

This method finds the index of the smallest value in array data, considering only the values with indices 
between start and end, inclusive. This method is similar to the min( method discussed earlier; how¬ 
ever, the one here doesn’t look at the entire array. For the program Sel ecti onSort, we didn’t need to be 
able to specify the upper limit for the indices because the method sort() always uses the index of the 
last element as the upper limit. Writing the method as shown here makes reusing the method easier in 
other programs where a varying upper limi t on the index might be needed. 
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# static void swap(int[] data, int first, int second)! 
int temp; 

temp = data[first]; 
data[first] = data[second]; 
data[second] = temp; 

} 

To keep the code for sortQ as short and clear as possible, we provide this method to swap the values 
stored at two different locations in an array. 



Pass 

! Elements of Array a[] After Each Pass 

a[0] 

all] 

a[2] 

a[3] 

a[4] 

a[5] 

a[6] 

a[7] 

Unordered data 

7 

3 

66 

3 

-5 

22 

-77 

2 

First 

-77 

3 

66 

3 

3 

22 

7 

2 

Second 

-77 

-5 

66 

3 

3 

22 

7 

2 

Third 

-77 

-5 

2 

3 

3 

22 

7 

66 

Fourth 

-77 

-5 

2 

3 

3 

22 

7 

66 

Fifth 

-77 

-5 

2 

3 

3 

22 

7 

66 

Sixth 

-77 

-5 

2 

3 

3 

7 

22 

66 

Seventh 

-77 

-5 

2 

3 

3 

7 

22 

66 


The first pass finds that the index of the smallest element is 6. The value at index 6 is 
swapped with the value at index 0 as shown in the row labeled First. In the second pass, only val¬ 
ues with indices 1 through 7 are examined. The next smallest element is at index 4. The value at 
index 4 is then swapped with the value at index I. The variable next in method swap() keeps 
track of where the newly selected element is supposed to be placed. This process continues until 
the entire array has been sorted. Note that, although the elements are actually in order at the end 
of the sixth pass, the program continues. In fact, during the last pass the element at index 6 is 
selected as the smallest and swapped with the element at 6, which of course doesn’t actually do 
anything. 



5.7 SEARCHING AN ORDERED ARRAY 


Let’s assume that an array has been ordered with elementa[0] < a[ 1 ] < ... < a[length - 1 ]. Now finding the 
minimum or maximum element can be done in a fixed number of operations, regardless of the size of the 
array. The minimum is the value a [0], and the maximum is the value a [length - 1] . Finding the minimum 
and the maximum require linear time for an unordered array. That is, the number of operations is directly 
proportional to the length of the array. 


What if we want to find the position of a given value in a sorted array? This problem is common in searching 
a large database. For example, most people have an identification code, usually their social security number. 
Their records, such as a credit or employment history, can be searched by using this identification code. In 
general, such an identification code is called a key when it is used for searching in a database. 











































































5.7 Searching an Ordered Array 133 

Let’s write a routine to look for a particular value in an ordered array and, if the value is found, return its 
position in the array. If the value isn’t found, the routine will return -1. 

static int linearSearch(int[] keys, int v) { 
for (int i = 0; i < keys,length; i++) 
if ( keys[i] == v) 
return i; 
return -1; 

} 

Note how the loop terminates if the element’s position is found. If the element isn’t found, the entire array 
will be searched. We call this procedure 1 i near Search () because the time required to find the desired ele¬ 
ment is proportional to the length of the array. We haven’t really taken advantage of the fact that the array is 
ordered. For an ordered array, we can improve on this performance by recognizing that, once we have a value 
larger than v, we can stop looking. 

static int betterLinearSearch(int[] keys, int v) { 
for (int i = 0; i < keys.length; i++) 
if ( keys[i] == v) 

return i; //just right 

else if (keys[i] > v) 

return -1; //too large 

return -1; // not found 

} 

For failed searches, this version should terminate on average in roughly half the time of the method 1 i n- 
earSearchQ. However, we still haven’t taken full advantage of the ordering information. 

Consider a number guessing game whereby you try to guess a number within a certain interval, using as few 
guesses as possible. If asked to guess a number between 1 and 100, inclusive, your optimal strategy is to 
guess 50. If the other person says that your guess is too big, you should next guess 25; if your guess was too 
small, your next guess should be 75. After each wrong guess reduce the range of possible guesses by half. 
Using this strategy, you will get the answer in at most seven guesses. The following program uses such an 
algorithm in the method bi narySearchQ. 

// BinarySearch.java - use bisection search to find 
// a selected value in an ordered array 
class BinarySearch { 

public static void main(String[] args) { 

int[] data = {100, 110, 120, 130, 140, 150}; 
int index = binarySearch(data, 120); 

System.out.print1n(index); 

} 

// find the index of element v in array keys 
// return -1 if it is not found 
static int binarySearch(int[] keys, int v) { 
int position; 

int begin = 0, end = keys.length - 1; 
while (begin <= end) { 

position = (begin + end) / 2; 
if (keys[position] == v) 

return position; // just right 

else if (keys[position] < v) 


begin = position + 1; 

// too 

small 

el se 



end = position - 1; 

// too 

big 


} 

return -1; 

} 


} 
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Each time through the whi 1 e loop, the search interval is halved—hence the name binarySearch(). Thus the 
search of an ordered array of keys will make at most 21og 2 (u) comparisons for an array with n elements. A 
search of roughly one thousand elements is accomplished in no more than 10 iterations (recall that 1024 is 
2 10 ), and a search of a milli on elements takes no more than 20 iterations (1,000,000 is approximately 2 20 ). 



5,8 B1C-OH: CHOOSING THE BEST ALGORITHM 


Our initial method, fi nd(), required as many as n - 1 comparisons, and our final version, binarySearchO, 
required at most 21og 2 (n) comparisons. We say that there are on the order of n comparisons in fi nd() and 
on the order of login) comparisons in bi narySearch(). Because this concept is so important in computer sci¬ 
ence, there is a special notation for it. We say that using f i nd () to find an element requires O(n) time. Read 
this expression as “on the order of n” or “order rc” or “big-oh of n” time. The notation is called big-oh nota¬ 
tion. 

More precisely, O(n) means that as n increases the quantity being measured is at most cxn for some con¬ 
stant c. In general, 0{f(n)) means that the quantity being measured is at most c x f(n) for some constant c. 
In our example, the quantity is the number of comparisons. 

When we convert an expression that involves several terms into bi|-oh notation, only i/ie fastest growing 
term remains. For example,3n + 20n + 15 is 0(n ) because cxn is larger than 3n + 20n + 15 for all 
values of n greater than 3, if c = 10. Similarly, 3n + 20 log(n) is Oiri) because n grows faster than log (ri). If an 
algorithm requires a fixed number of operations, regardless of the size of the problem, it is 0(1); it is also 
known as requiring constant time. 

In most cases, an algorithm that requires 0(log(n)) time is better than an algorithm that requires 0(n) time. 
However, there may be some small values of n for which the Q(n) algorithm is better. Suppose that the actual 
number of operations for the Oilog(ri)) algorithm was 512 login) and the actual number of operations for the 
Oin) algorithm was 5 n. Then the Oin) algorithm will be faster for all values of n less than 1024. 

An algorithm that completes in Oin) time is said to be a linear time algorithm because the running time is 
bounded by a linear function. Similarly, an Oilogin)) algorithm is said to be logarithmic and an Oi 2 n ) algo¬ 
rithm is exponential. 

Sometimes, big-oh notation isn’t enough to help you choose the best algorithm. It can be proved that n - 1 
comparisons are needed to find either the minim um or the maximum element in an array. Does that mean 
that ArrayTest finds the minimu m and the maximum using the fewest number of comparisons? The answer 
is no. The following method, mi nMaxArray (), shows how to determine the maximum and the minimum of an 
array, using approximately 25 percent fewer comparisons involving array elements. 

static int[] minMaxArray(int[] data) { 

int[] minMax = new int[2]; //store min and max 

// the length must be even 

int midPoint = data.length / 2; 

// loop puts the min somewhere in the first half 
// and the max somewhere in the second half 
for (int i =0; i < midPoint; i++) 
if (datafi] > datafmidPoint + i ]) 
swap(i, midPoint + i, data); 

// loop finds the min which must be in first half 
minMax[0] = data[0]; 
for (int i =1; i < midPoint; i++) 
if (data[i] < minMax[0]) 
minMax[0] = datafi]; 
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// loop finds the max which must be in second half 
minMax[l] = data[midPoint]; 

for (int i = midPoint + 1; i < data.length; i++) 
if (data[i] > minMax[l]) 
minMax[l] - data[i]; 
return minMax; 

} 

static void swap(int i, int j, int[] data) { 
i nt temp = data[i]; 
data[i] - data[j]; 
data[j] = temp; 


With mi nMaxArray (), we can find the minimum and the maximum value in an array by using 
3(n/2 - 1) comparisons involving array elements. Each loop executes n/2 - 1 comparisons. In the program 
ArrayTest, the two methods used to find the minimum and the maximum use 2(n- 1) comparisons 
involving array elements. 

Although the mi nMaxArray () solution requires fewer comparisons involving array operations, it is clearly a 
more complex solution, and for small values of n it will even take longer to execute. When you use big-oh 
notation, the algorithms are considered to have the same complexity: Both are CKn). 
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5.9 TYPE AND ARRAY 


So far, most of our examples have involved the i nt type. In this section we use one-dimensional arrays of 
different data types. We also demonstrate techniques and idioms that are co mm on to these different data 
types. 


5,9,1 BOOLEAN5: THE SIEVE OF ERATOSTHENES 

Let’s say that we want to find the prime numbers between 2 and 100. To do so, we write code based on the 
sieve of Eratosthenes. We allocate a boolean array i sPri me of 100 elements. We set each element to true. 
Starting with element i sPri me [2] we use its index value 2 and proceed through the remaining array ele¬ 
ments isPrime[4], isPrime[6], . .. , isPrime[98], setting each value to false. Then we go to isPrime[3] 
and set each element at a spacing of 3 to false. We do this until we reach 10, because 10 is the square root of 
100 and is sufficient for checking primality in the range 2 through 100. When we have finished, only those 
entries that remain true are primes. 

//Primes.java-Sieve of Eratosthenes for Primes up to 100. 
class Primes { 

public static void main(String[] args) { 
boolean[] isPrime = new boolean[100]; 
int i ; 

System.out.println(" Table of primes to 100."); 
for (int i =0; i < isPrime.1ength(); i++) 
isPrime[i] = true; 

for (int j - 2; j < Math.sqrt(100); j++) 
if (isPrime[j]) 

cross0ut(isPrime, j, j + j); 
for (i = 2; i < 100; i++) //print primes 
if (isPrime[i]) 

System.out.print(" " + i); 


} 
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public static void crossOut(boolean[] s, int interval, int start) 

{ 

for (int i = start; i < s.length; i += interval) 
s[i] = false; 

} 


We can readily generalize this program to an arbitrarily large n. The key would be to replace the hardcoded 
value 100 with a variable n. We leave this for you to do as Exercise 2 on page 156. 


5.9.2 char: USING A LINE BUFFER 


Much of character processing is done by sequentially examining a sequence of characters stored in an array 
called a buffer. For example, in a word processing program we might want the capability to count words. To 
do so we would store a line of text in a buffer and examine the characters in the buffer. A word might be 
defined as a sequence of alphabetic characters that are adjacent. We write just this program and dissect the 
parts of it that are idiomatic of character processing. 


//CountWord.java 
import java.1ang.*; 
import java.util.*; 


public class CountWord { 

public static void main(String[] args) { 

String input; 

Scanner scan = new Scanner(System.in); 
char[] buffer; 

System.out.println("type in line"); 
input = scan.nextLine(); 

System.out.println(input); 
buffer = input.toCharArray(); 

System.out.println("word count is " + wordCount(buffer)); 


//words are separated by nonalphabetic characters 
public static int wordCount(char[] buf) { 
int position = 0, wc = 0; 
while (position < buf.length) { 

while (position < buf.length && !isAlpha(buf[position])) 
position++; 

if (position < buf.length) 
wc++; 

while (position < buf.length && isAlpha(buf[position])) 
position++; 

} 

return wc; 


public static boolean isAlpha(char c) { 
return (c >= 'a' && c <= 'z') || (c >= 

} 


'A 1 && c <= 'Z') ; 


} 
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Dissection of the CountWord Program 


# String input; 

Scanner scan = new Scanner(System.in) ; 
char[] buffer; 

System.out.printlnC’type in line" ); 
input = scan.nextLineO; 

The Stri ng variable i nput is used to capture an input line typed at the keyboard. We use the method 
nextLi ne(), which captures a line after Enter is hit. 

# buffer = input.toCharArrayO; 

System.out.println("word count is " + wordCount(buffer)) ; 

The Stri ng method toCharArrayO converts the Stri ng to an array of characters. Stri ng, Stri ng- 
Buffer, and char [] are all important types that can be used to manipulate sequences of characters. 
Using a char [] is the most fundamental of these schemes and is often the most efficient. We call the 
method wordCount () to count the words in the buffer. 

# public static int wordCount(char[] buf) { 

int position = 0, wc = 0; 
while (position < buf.length) { 

while (position < buf.length && !isAlpha(buf[position])) 
position++; 

We process this character array buf [] from the zeroth character to the buf. 1 ength - 1 character. Our 
definition of a word is a sequence of alphabetic characters. We advance through the buffer until we find 
a first alphabetic character. Note that the boolean method i sAl pha() returns true when the character 
value passed in as its actual parameter is an English letter. All the characters in the buffer could be non- 
alphabetic. In that case we need to verify that the word count is zero. 

# if (position < buf.length) 

wc++; 

while (position < buf.length && isAlpha(buf[position])) 
position++; 

If we have reached an alphabetic character before we reach the last position In the buffer, we have a new 
word and can Increment wc. We then sequence through adjacent alphabetic characters. We return to the 
outer loop and check to be sure that we haven’t reached the end of the buffer. 

# public static boolean isAlpha(char c) { 

return (c >= ‘a’ && c <= T z’) |[ (c >= 'A T && c <= 'Z') ; 

} 

The boolean method i sAl pha() is by convention named isSomeProperty. It relies on the property of the 
Unicode table wherein the alphabetic characters are in the right order sequentially. 



This example should help you understand the Stri ng and Stri ngBuffer classes provided In the Java librar¬ 
ies. 


5.93 double: ACCUMULATE, A GENERALIZATION OF sum 


One of our first array examples was sum(), which worked on an i nt type. This code is also useful for other 
types. It can be overloaded for the type doubl e, as follows. 
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//Sum the double elements in an array, 
static double sum(double[] a) { 
double sum = 0.0; 
for (int d: a) 
sum = sum + d; 
return sum; 

} 

We can further generalize this code and make it useful for a wider range of computations. We can sum an 
array over a range from the first element up to, but not including, the last element. We can also accumulate 
from a starting value that may be different from the value 0. Such a general algorithm is as follows. 

//Accumulate the double elements in an array, 
static double sum(double[] a, int first, int last, 

double initialValue) 

{ 

for (int i = first; i < last; i++) 
initial Value += a[i]; 
return initialValue; 

} 

This code shows many features of generalizing a basic method by extending its abilities with additional vari¬ 
ables. 



5.10 TWO-DIMENSIONAL ARRAYS 


The arrays in the preceding sections are all one-dimensional arrays; that is, the elements are conceptually in 
a single row or column. Java allows arrays of any type, including arrays of arrays. Recall that, for any type T, 
T[] is the notation for the type array of Ts. The type T can itself be an array. With two bracket pairs, we 
obtain a two-dimensional array consisting of rows and columns. This idea can be iterated to obtain arrays of 
higher dimension. With each bracket pair, we add another array dimension, as for example in 

String[] up; //one dimension 

doublet] [] upUp; //two dimensions 

char[][][] andAway; //three dimensions 

We focus on two dimensions because these arrays constitute the most useful and used of the multidimen¬ 
sional array types. We can conveniently think of a two-dimensional array as a rectangular collection of ele¬ 
ments with rows and columns. For example, if we declare 

int□ [] data - new int[3][5]; 

then we can think of the array elements being arranged as follows. 


.. 

Cot 1 

Col 2 

COL S 

Col 4 1J 

.XX:: :: X; . . . 

Col 5 

Row 1 

a[0][0] 

a[0][1] 

a[0][2] 

a[0][3] 

a[0][4] 

Row 2 

a[l][0] 

a[l][1] 

a[l][2] 

a[l][3] 

a[l][4] 

Row 3 

a[2][0] 

a[2][1] 

= -■- - --J 

a[2][2] 

a[2][3] 

a[2][4] 


To illustrate these ideas, let’s write a program that fills a two-dimensional array with some internally gener¬ 
ated values. 
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5.10.1 Two-dimensional initializer Lists 

// TwoD.java - simple example of two-dimensional array 
class TwoD { 

public static void main(String[] args) { 
int[][] data = new int[3][5]; 
for (int i = 0; i < data.length; i++) { 

System.out.print(”Row " + i + "); 

for (int j = 0; j < data[i].length; j++) { 
data[i][j] - i * j; 

System.out.print(data[i] [j] + ", ") ; 

} 

System.out.println(); 

} 

} 

} 
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Dissection of the TwoD Program 


int[][] data = new int[3][5]; 


This statement does three things. It declares the variable data to be a reference to a two-dimensional 
array of integers. It creates an array with three rows and five columns. Finally, it assigns data to refer to 
the newly created array. We don’t need to create the array in the same statement that declares the vari¬ 
able. However, we must create an array and assign data to refer to that array before we can use data. A 
common mistake is to forget to create the array. 


# for (int i = 0; i < data.length; i++) { 
System.out.print("Row " + i + "); 


* * ■ 


} 


System.out.println(); 


Phis is the outer loop. For multidimensional arrays, we can write an expression to find the size of each 
dimension. The expression data. 1 ength evaluates to the length of the first dimension. Each iteration of 
this loop will print one row of the array. 

for (int j = 0; j < data[i].length; j++) { 
data[i][j] = i * j; 

System.out.print(data[i][j] + ", "); 

} 


This loop is the inner loop. A pair of nested loops or accessing a two-dimensional array is an important 
idiom. The expression data[i] [j] is of type int, one of the elements of the array. The expression 
data[i ] is of type i nt [], one of the rows of the array. From it we get the expression data[i ] .length 
for the row size used inside the inner loop to process each i th-row element. 
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5.10,1 TWO-DIMENSIONAL INITIALIZER LISTS 

A two-dimensional array can be explicitly initialized with a set of values. The rows are also contained in a set 
of braces. Each of the following initializations creates a two-dimensional array with a total of six elements. 
But their layout—-in other words—their row organization—is completely different. Array a has three rows of 
two elements each. Array b has two rows of three elements each. Array c has one row of six elements and is 
a degenerate two-dimensional array. Array ragged has three rows, each with a different number of elements. 
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int[][] a = {{1, 2}, {3, 4}, {5, 6}}; 
int[] [] b = {{1, 2, 3}, {4, 5, 6}}; 
int[][] c = {{1, 2, 3, 4, 5, 6}}; 

int [][] ragged - {{1,2}, {3, 4, 5}, {6}}; 

As this example shows, in Java we can create a two-dimensional array that isn’t rectangular. Thai is, the num¬ 
ber of elements in each row can be different. This approach works because a two-dimensional array of inte¬ 
gers is really a one-dimensional array of references to one-dimensional arrays of integers. The following 
diagram shows the layout of array ragged. 




5.11 AN ELEMENTARY SIMULATION: THE “GAME OF LIFE” 


The Game of Life is an archetypal checkerboard simulation. It was invented by the English mathematician 
John H. Conway for exploring certain formal situations involving reproduction and growth (see Scientific 
American, October 1970, p. 120). The game is a successor to the work of John von Neumann on cellular 
automata. 

A checkerboard simulation is a model wherein the world is broken into a rectangular array of cells. Each cell 
may interact only with its neighboring cells, the interactions occurring once per simulated clock pulse. The 
rules for a local change are well defined and simple, but predicting global change is impractical without com¬ 
puter simulation. The Game of Life has the following rules. 

Game of Life Rules 

1. A cell is either empty, indicated by a blank, or alive, indicated by an X. 

2. Each cell is the center of a 3 x 3 square grid of cells, which contains its eight neighbors. 



3. A cell that is empty at time t becomes alive at time t + 1 if and only if exactly three neighboring 
cells were alive at time t. 

4. A cell that is alive at time t remains alive at time t + 1 if and only if either two or three neighbor¬ 
ing cells were alive at time t. Otherwise, it dies for lack of company ( < 2 ) or overcrowding ( > 3 ). 

5. The simulation is conducted, in principle, on an infinite two-dimensional grid. 

A simulation starts with an initial configuration of Xs on the grid. The following example of a simple repeat¬ 
ing life form is called a blinker , as it repeats every two generations, or time steps. 
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5.11.1 THE GAME OF LIFE: REQUIREMENTS ANALYSIS AND DEFINITION 

In software development, we must first add a few refinements to the specification of the program just 
described. 

$ Instead of trying to simulate an infinite two-dimensional grid, simulating a relatively small grid will suf¬ 
fice. 

Because the grid isn’t infinite, we must decide how to deal with the borders. To keep the program simple, 
we will treat the borders as lifeless zones. 

# The initial placement of life forms in the grid will be read from the console as a sequence of Xs and dots. 
The Xs will stand for life forms and the dots will represent empty cells. If the grid was only 5 x 5 as 
shown in the preceding figure, the initial configuration would be specified at the console by typing 


. .X. . 

Y 

* * /\ 4 IT 

. .X. . 


# The user will specify the size of the grid, which will always be a square grid, and the number of genera¬ 
tions to simulate. 

# The program should echo the initial generation and then print each new generation simulated. 

t' 

5.11.2 THE GAME OF LIFE: DESIGN 

We are now ready to begin designing the program. The first—and obvious-decision is that we will use a two- 
dimensional array to represent the grid. We start with pseudocode for the top level. 

Top-level pseudocode for the Game of Life 

read in the size of the grid 
read in the initial generation 
read in the number of generations to simulate 
print the current generation 
for the specified number of generations 
advance one generation 
print the generation 
end for loop 

The most difficult step is “advance one generation” so we need to write some pseudocode for advancing one 
generation. 

Pseudocode for advancing one generation 


for each ce' 
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compute the number of neighbors 

apply the game rules to decide if the cell 

should be alive or dead in the next generation 
end for loop 

Applying the game rules to one cell isn’t too hard once we know the number of neighbors. The code will be 
some i f-el se statement. Either the new cell will be dead or it will be alive. Computing the number of neigh¬ 
bors still looks difficult. However, there are several approaches that we can use to solve this problem. A cell 
and its neighbors can be viewed as a 3 x 3 subarray. With this in mind, we write the following pseudocode for 
counting the neighbors. 

Pseudocode for computing the number of neighbors 

visit each cell in the 3x3 subarray around the cell 
keep a count of how many of those are alive 
if the center cell is alive 

then return one less than the count found 
else return the count found 

At this point in the design we need to recognize that we can’t simply update the cells in the array as we visit 
each of them while advancing one generation. A generation is a snapshot of the grid at an instant in time. 
Changing some of the cells will affect the number of neighbors that another cell observes. This type of 
unsynchronized updating of the cells might be interesting, but it isn’t what Conway intended in his Game of 
Life. We need to not disturb the current generation while creating the next generation. As is often the case, 
there are several solutions. The one that we have chosen is to use two arrays: one for the current generation 
and another for the next generation. 

Before moving to the implementation stage, we have to refine two of the sections of our pseudocode. 

Refined top-level pseudocode for the Game of Life 

read in the size of the grid 

create two arrays, currentGen and nextGen 

read the initial generation into currentGen 

read in the number of generations to simulate 

print currentGen 

for number of generations 

update nextGen using currentGen 
swap currentGen and nextGen 
print currentGen 
end for loop 

Each iteration of the loop fills the cells of nextGen from the values found in currentGen. Then the arrays 
referred to by nextGen and currentGen are swapped. Note that after the last iteration currentGen will have 
the data of the most recently computed generation. 

Refined pseudocode for advancing one generation 

input: currentGen and nextGen 
output: updated nextGen 
for each cell in currentGen 

compute the number of neighbors 

apply the game rules to decide if the cell 
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should be alive or dead in the next generation 
store the result, alive or dead, in the 
corresponding cell in nextGen 
end for loop 


5,1 1.3 THE GAME OF LIFE: IMPLEMENTATION 

The parts of the program for which we haven’t presented pseudocode are sufficiently simple that we can pro¬ 
ceed directly to the complete program at this point. Although some of those parts are nontrivial, the 
pseudocode for them is almost identical to the final code. 

//GameOfLife.java - Conway's Game of Life 
class GameOfLife { 

public static void main(String[] args) throws java.io.IOException 

{ 

// read in the size of the grid and create arrays 
int size = 10; // fix at 10 for testing 
boolean[][] currentGeneration, nextGeneration; 
currentGeneration = new boolean[size][size]; 
nextGeneration = new boolean[size][size]; 
readlnitialGene ration(currentGenerati on); 

// read in the number of generations to simulate 
int cycles = 4; // fix at 4 for testing 
pri ntState(currentGeneration); 
for (int i =0; i < cycles; i++) { 

System.out,println("Cycle = " + i + "\n\n M ); 
advanceOneGen(currentGenerati on, nextGeneration); 
printState(nextGeneration); 

// swap current and next generations 
boolean[][] temp = nextGeneration; 
nextGeneration = currentGeneration; 
currentGeneration = temp; 

} 

} 

// read the initial generation from the input 
// a dot means empty and an X means alive 
// any other characters are ignored 
// the border cells are all set to empty 
// the method assumes the array is square 

static void readlnitialGeneration(boolean[][] w) throws java.io.IOException 

{ 

for (int i = 0; i < w.length; i++) { 
for (int j =0; j < w[i].length; j++) { 
char c = (char)System.in.read(); 

//skip illegal characters 
while (c !- && c != 1 X 1 ) 

c = (char)System.in.read(); 
if (c == ’.’) 

w[i] [j] - EMPTY; 
el se 

w[i] [j] - ALIVE; 

} 


} 
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//set border cells to be empty 
int border = w.length - 1; 
for (int i = 0; i < w.length; i++){ 
w[i][0] - w[0][i] - EMPTY; 
w[i][border] = w[border][i] = EMPTY; 

} 

} 

// print a generation to the console 
static void printState(boolean[][] w) { 
for (int i =0; i < w.length; i++) { 

System.out.printlnQ ; 
for (int j =0; j < w[i].length; j++) 
if (w[i][j] — ALIVE) 

System.out.print( f X’); 
el se 

System.out.print(’.'); 

} 

System.out.println(); 

} 

// compute the number of alive neighbors of a cell 
static int neighbors(int row, int column, boolean[][] w) 

{ 

int neighborCount = 0; 
for (int i = -1; i <= 1; i++) 
for (int j = -1; j <= 1; j++) 

if (w[row + i][column + j] == ALIVE) 
neighborCount = neighborCount + 1; 
if (w[row][column] == ALIVE) 
neighborCount--; 
return neighborCount; 

} 

r 

static void advanceOneGen(boolean[][] wOld, boolean[][] wNew) 

{ 

int neighborCount; 

for (int i =1; i < wOld.length - 1; i++) { 
for (int j = 1; j < w01d[i].length - 1; j++) { 
neighborCount = neighbors(i, j, wOld); 
if (neighborCount == 3) 
wNew[i][j] - ALIVE; 

else if (w01d[i][j] == ALIVE && neighborCount == 2) 
wNew[i][j] - ALIVE; 
el se 

wNew[i][j] - EMPTY; 

} 

} 

} 

static final boolean ALIVE = true; 
static final boolean EMPTY = false; 
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Dissection of the GameOfLife Program 


# public static void main(String[] args) throws java.io.IOExceptoin 

{ 

// read in the size of the grid and create arrays 
int size =10; // fix at 10 for testing 
boolean[][] currentGeneration, nextCeneration; 
currentGeneration = new boolean[size][size]; 
nextCeneration = new boolean[size][size]; 

Following the pseudocode developed earlier, we need to read in the size of the grid and create the arrays. 
For testing purposes we have fixed the size at 10. In the final version of the program we would replace 
the assignment of 10 to si ze with a prompt to the user for the desired size and an input statement to 
read the size from the console. We create two square arrays to represent the cells in the world. Each gen- 
eration, the cells in currentGeneration are used to update the cells in nextGeneration. Because a cell 
can only be alive or empty, we use the primitive type bool ean for the cells. The value true means that 
the cell is alive, java will initialize all array elements to fal se, which means empty in our simulation. The 
throws clause here is required because of the method used for reading input in readlnitialCenera- 
ti on () . See Chapter 11, Coping with Errors for more information on exceptions. 

% readlnitialGeneration(currentGeneration); 

The method readlni ti alGenerati on() is used to read an initial world from the console. When the 
method returns, the cells in currentGenerati on will have been modified to correspond to user input. 

# // read in the number of generations to simulate 

int cycles =4; // fix at 4 for testing 

printState(currentGeneration); 

This comment from the pseudocode reminds us that we haven’t finished the implementation. As with 
the size of the grid, we’ve fixed the number of generations to simulate. The method pri ntState() will 
print to the console the initial generation, which is stored in currentGenerati on. 

# for (int i =0; i < cycles; i++) { 

System.out.println("Cycle = " + i + ”\n\n M ); 
advanceOneGen(currentGeneration, nextGeneration); 
printState(nextGeneration); 

// swap current and next generations 
boolean[][] temp = nextGeneration; 
nextGeneration = currentGeneration; 
currentGeneration = temp; 

} 

This loop is the main simulation loop. Each iteration, the next generation is computed and the state is 
printed. At the end of each iteration, the array variables referring to the two arrays are reversed so that, 
at the start of the next iteration, currentGeneration points to the most recently updated array and 
nextGeneration refers to the array with the older generation, which subsequently is modified to con¬ 
tain the newest generation. Recall that this swapping of the array variables isn’t copying the entire array; 
it is simply changing the variables to refer to different arrays. 
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# static void read!nitialGeneration(boo1ean[][] w) 

throws java.io.IOException 

{ 

for (int i - 0; i < w.length; i++) { 
for (int j = 0; j < w[i].length; j++) { 
char c = (char)System, in. readQ ; 

//skip illegal characters 
while (c != ' && c ! = 'X 1 ) 

c = (char)System.in.read(); 
if (c = 1 .’) 

w[i3[j] - EMPTY; 
el se 

w[i] [j] - ALIVE; 

} 

} 

Input in this method is done using System .in. read() which reads one character at a time. We do not 
need the parsing power of Scanner. In fact Scanner does not have a method for reading one character 
at a time. The more basic System. i n . read () may throw an exception which must be declared. See 
Chapter 11, Coping with Errors for more information on exceptions. The while loop is used to skip over 
any white space or other unexpected characters. To make the code more self-documenting, we have 
defined constants to encode the fact that true will be treated as ALIVE and that false will be treated as 
EMPTY. The constants are defined at the end. 

int border = w.length - 1; 
for (int i = 0; i < w.length; !++){ 
w[i][0] - w[0][i] = EMPTY; 
w[i][border] = w[border][i] = EMPTY; 

} 

} 

As discussed in the design section, the border cells require some form of special treatment because they 
have fewer than eight neighbors. Recall that we decided to treat the border cells as a lifeless zone. To 
enforce that we set all border cells to EMPTY, ignoring border values that were supplied by the user. This 
code makes the unchecked assumption that the array is actually square. 

# static void printState(boolean[][] w) { 

for (int i = 0; i < w.length; i+4-) { 

System.out.println(); 
for (int j ^ 0; j < w[i].length; j++) 
if (w[i][j] r = ALIVE) 

System.out.print('X'); 
else 

System.out.print('.'); 

} 

System.out.println(); 

} 

This routine prints the state to the console, with the output format the same as that used for the input. 
The code doesn’t take advantage of the fact that the elements in the array are actually of type bool ean. 
At some later time the decision to use a boolean array might be changed. In that case, only the type of 
the parameter in the method header would need to be changed. In addition, by using the constant ALIVE, 
the code is self-documenting. It should be clear that X is printed if the cell is ALIVE and that a dot is 
printed otherwise. 
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static int neighbors(int row, int column, 
int neighborCount = 0; 


boolean[][] w) { 


for (int i = -1; i <= 1; i++) 
for (int j = -1; j <= 1; j++) 

if (w[row + i][column +j] == ALIVE) 
neighborCount = neighborCount + 1; 
if (w[row][column] == ALIVE) 
neighborCount--; 
return neighborCount; 

} 

This routine counts the number of neighboring cells that are alive. It does so by counting the number of 
alive cells in the 3x3 subarray that has the specified cell at its center. Then the center cell is removed 
from the count if it is alive because a cell isn’t a neighbor to itself. If this routine is called with a cell on 
the border of the array, an IndexOutOf Bound sExcept i on error message is printed. In our program, that 
never happens because nei ghbors () is never called with the coordinates of a border cell. 

• static void advanceOneCen(boolean[][] wOld, boolean[][] wNew) 

{ 

int neighborCount; 

for (int i =1; i < wOld.length - 1; i++) { 
for (int j =1; j < w01d[i].length - 1; j++) { 
neighborCount = neighbors(i, j, wOld); 
if (neighborCount == 3) 
wNew[i][j] = ALIVE; 

else if (w01d[i][j] — ALIVE && neighborCount == 2) 
wNewfi][j] = ALIVE; 
else 

wNew[i][j] - EMPTY; 

} 

} 

} 

Tiiis method implements the rules of the simulation. The array wOl d is examined to determine the cur¬ 
rent number of neighbors for each ceil, and then the array wNew is set according to the rules. These loops 
avoid the borders of the array, implementing our design decision that the borders will be lifeless zones. 

# static final boolean ALIVE = true; 
static final boolean EMPTY = false; 

To make the code more self-documenting, the program uses these two constants. Without the constants, 
we would need to add some comment. For example, without a comment in 

wNew[i][j] = true; 


the user must remember that true is used to mark alive cells. A comment would help, but self-docu- 
menting code is always preferable. Comments can become out of date when a progr amm er modifies the 
code but doesn’t update the comments accordingly. 



The GameOf Li f e program requires enough input that typing the input in each time would be rather tedious. 
Instead, you can prepare an input file and then use file redirection to cause the program to read from the file 
instead of from the keyboard. Suppose that the file glider contains 
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y y 

m A ■ ■ /\ m m m • * 

.X.... 

y y 

a A * ■ * /V a ■ # g 

..xxxx_ 


Then we can run GameOf Li f e by having it read characters from glider instead of the keyboard. To have it do 
so we type the following command at either a Unix or DOS command prompt. 

java GameOfLife < glider 

Execution of this command would be followed immediately by the program output. A portion of the output 
would be 


■ ■*■*««*■* 
y y 

m A « v /\ i • a > t 

.X_ 

y y 

a /v • « ft A * ■ * « 

..xxxx_ 


ft 


Cycle = 0 

(intermediate cycles deleted to save space) 
Cycle = 3 


...X..X... 

. . ._X. . 

y y 

ft ft ft /\ ft: « ■ /\ ft ft 

_ XXXX.. 


ftflftftftftftftftft 


Note that, after four cycles, the initial configuration has reappeared but has moved to the right by two posi¬ 
tions. This interesting “life form” is one of many that have been discovered. This one is called a glider 
because it sort of glides across the simulated world. 
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5.12 ARRAYS OF NONPRiMITIVE TYPES 


At the beginning of this chapter we said that an array can be created from any type T by using the notation 
T[]. The elements in the arrays presented so far have all been primitive values. As discussed earlier, two- 
dimensional arrays were actually arrays of arrays, but ultimately the elements of the arrays were always 
primitive values. In this section we take a brief look at some arrays of nonprimitive elements. 


5,12.1 ARRAYS OF STRINGS 

The nonprimitive type that we have used the most so far is the type Stri ng. We can create a variable of type 
“array of strings” with 

String[] myStringArray; 

Recall that, as with other arrays, this statement doesn’t create an array but a reference to an array. To create 
an array of 10 string variables we can use 

myStringArray = new String[10]; 

Initially each of the Stri ng variables, myStri ngArray [i ], has the value null. To get them to refer to some 
actual strings, we must assign them values, as for example, 

myStri ngArray [0] = ’’zero"; 
myStri ngArray [1] = ’’one” ; 


A common mistake is to create an array of references to Stri ng or some other nonprimitive type, and then 
forget to create the actual object values and assign them to the elements in the array. 


Because Java provides special syntax for creating string literals, the same array initializer notation used ear¬ 
lier can be used with strings. The same effect of creating an array of 10 strings containing the strings for 0 
through 9 can be achieved with an array initializer. The following example demonstrates this approach. 


// StringArray.java - uses a string array initializer 


class StringArray { 

public static void main(String[] args) { 
String[] myStringArray = { "zero”, "one", 

"five”, "six", 

for (int i =0; i < myStringArray.length; 
System.out.println(myStri ngArray[i ]); 

} 

} 


"two", "three", "four", 
"seven", "eight", "nine"}; 

i++) 


The output of the program is the words zero, one, two,ni ne—one per line. 

We now see that the f amili ar 

public static void main(String[] args) 

is actually declaring that the method mai n () is expecting an array of strings as a parameter. The only ques¬ 
tion that remains is, “where does the array come from?” 

The answer is that this array will be filled with any strings included after the name of the class used to start a 
Java program. These are called the command line arguments used to run the program. Each element in the 
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array contains one, white space delimited, string from the command line. The following program prints out 
any command line arguments. 

// CommandLine.java - print command line arguments 
class CommandLine { 

public static void main(String[] args) { 
for (int i = 0; i < args.length; i++) 

System.out.print!n(args[i]); 

} 

} 

The following line shows the program being started from a Unix or Windows command line prompt, followed 
by the output. 


os-prommpt>java CommandLine this is a test 
this 

m 

i s 
a 

test 


You can insert spaces in a single co mm and line argument by putting the argument in quotes. This approach 
is shown in the following execution of the same program 


os-prompt>java CommandLine this "is another" test 
this 

is another 
test 


Note that the quotation marks aren’t part of the argument and that the second argument includes a space. 



5.13 THE CONTAINER ArrayListo 


The ArrayList class is one of a number of container classes in the java.util package. It implements a growable 
array. Like an array, it contains indexed elements. Unlike an array, the size of a ArrayList can grow or shrink 
dynamically, as needed. This added feature comes at a small cost, so most programs use arrays when they 
are adequate. 


We will write an example showing how the ArrayList container grows. In this example we take strings stored 


in an array and repeatedly store them in an ArrayList. The ArrayList grows dynamically to accommodate this. 
We will use the method add() that places a value at the end of the specified ArrayList. Here is a short 
description in table form of ArrayList operations. 
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ArrayList Method 

Purpose 

ArrayList() 

Constructor of an ArrayList 

ArrayList(int capacity) 

Construct this capacity 

add(Type e) 

insert e at back 

add(int i, Type e) 

insert e at position i 

contains(Type e) 

Is e in ArrayList? 

get(int i) 

return e at position i 

indexOf (Object e) 

return index for e 

remove(Object e) 

removes first e 

removeAll (Object e) 

removes all e 

sizeQ 

return size of the ArrayList 


// StringArrayList.java - uses an ArrayList Container 
import java.util.*; 
class StringArrayList { 

public static void main(String[] args) 

{ 

ArrayList<String> myStringArray= new ArrayList<String>(); 

String[] data - {"one", "two”, "three”}; 
for(int i = 0; i < 5; i++) 
for (String s : data ) 
myStringArray.add(s); 

System.out.println("\n ArrayList of Strings\n"); 
for (String s : myStringArray ) 

System.out.printIn(s); 

} 

} 

The array data has exactly three elements. The ArrayList myStri ngArray grows to accomodate 15 ele¬ 
ments. The type ArrayLi st<Stri ng> declares an ArrayLi st container that is only allowed to store Stri ng 
objects. We can make ArrayLi sts that store any non-primitive type T using ArrayLi st<T>. It is also possi¬ 
ble to put primitive types such as i nt into an ArrayLi st but the ArrayLi st must be declared using the cor¬ 
responding wrapper type from java.util. For example, to store integers we would use 
ArrayList<Integer>. 

Let us use this container to read in a file of text using redirection. We will then count the words that match a 
particular string, such as the string “for”. 

// FindWord.java - uses a ArrayList Container 
import java.util.*; 
class FindWord 
{ 

public static void main(String[] args) 

{ 

ArrayList<String> words = new ArrayList<String>(); 

Scanner scan = new Scanner(System.in); 

whi le(scan. hasNextQ) 

words .add(scan. nextQ) ; 

System.out.println("String occurred " + 

HowMany(words, "String") + " times."); 


} 
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static int HowMany(ArrayList<String> w, String lookfor) 

{ 

int count = 0; 
for ( String s:w ) 

if (s.equals(lookfor)) 

++count; 
return count; 

} 

} 

In this example, we see how several powerful classes work to make this text matching program easy to write. 
The Arrayli st<Stri ng> words provides an expandable container for the input strings. The construct 
s. equal s(lookfor) is used to see if Stri ng variables s and lookfor are equivalent strings. Running this 
program on the file FindWord.java results in counting 6 “String”’s. 



5.14 PROBLEM SOLVING: PALINDROMES 


Let us use an ArrayList to read in and decide whether a string of words is a palindrome. A palindrome is a 
sequence that is the same read forward or backward, as in “my oh my”. 

// Palindrome.java - uses an ArrayList container 
import java.util.*; 
class Palindrome 

{ 

public static void main(String[] args) 

{ 

ArrayList<String> words = new ArrayList<String>(); 

Scanner scan = new Scanner(System.in); 
whi1e(scan.hasNext()) 

words.add(scan.next()); 

System.out.printlnC’Is it a palindrome? " + isPalindrome(words)); 

} 

static boolean isPalindrome(ArrayList<String> w) 

{ 

int front = 0, back = w.sizeO - 1; 
while( front < back) 

if (!w.get(front++).equals(w.get(back--))) 
return false; 
return true; 

} 

} 

In order to use a standard array for this problem we would have to either know in advance how many words 
were going to be read in, or at least have an upper bound on the number of words. In that case we could cre¬ 
ate an array large enough to hold the ma xim um number of words we expected, keeping a count of the actual 
number of words read. 



5.1 5 PROGRAMMING STYLE 


Stylistically the most co: 

for (int i = 0; i < 
computation on d [i ] 


mil 


on array idiom in Java is 


d.length; i++) 
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This idiom is preferred to an explicit use of an array upper bound, as in 

for (i nt i = 0; i < N; i++) 
computation on d [ i ] 

The use of such an explicit bound, N, is more error prone and requires more code maintenance than does the 
preferred idiom. It is a carryover from C programming style, where arrays don’t have a length member. 

Even better, when applicable is the for-iterator statement, as in 

for (int element : d) 

computation on element //iterating over d[] 

This idiom is also applicable to containers, such as ArrayList. 

When computing over an array, you should package the computation as a method, as in 

static T computeArray(T[] a) { 

* * ■ 

for (int element : a) 
compute on element; 

B ■ ■ 

} 


5.15.1 COUNTING FROM ZERO 

Much of the syntax for Java is derived from the programming language C. For a number of reasons, C pro¬ 
grammers tend to write loops that begin with the loop index at 0. One reason is that in C, arrays are repre¬ 
sented in such a way that they are always indexed from 0. This C idiom has survived into Java so that even 
loops that are not indexing an array often start from 0. 

static void printRandomNumbers(int k) { 
for (int i = 0; i < k; i++) 

System, out .pri ntl n($ath. randomO) ; 

} 

However, people more naturally count from 1. Rewriting this code to start from 1 gives 

static void printRandomNumbers(int k) { 
for (int i =1; i <= k; i++) 

System, out. pri ntl n (Math. randomO) ; 

} 

Either style is reasonable. You need to be able to write and understand code with both counting styles. Many 
tricky bugs enter code when the end values of loops are off by one. 



Summary 

• An array is a data type used to represent a large number of homogeneous values. It is an elementary 
form of container. 

# Array allocation starts with element 0. The elements of an array are accessed by the use of index expres¬ 
sions. Therefore an array of size number of elements is indexed or subscripted from 0 to size - 1 , inclu¬ 
sive. The array size can be accessed by using the notation ar rayVari abl e. 1 ength. 
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# Allocation is often combined with declaration, as in 
int[] data = new int[100]; 


The expression a [expr], where expr is an Integral expression, accesses an element of the array. We call 
expr a subscript, or index, of a. The value of a subscript should lie in the range 0 to length - 1, inclusive. 
An array subscript value outside this range will cause an IndexOutOfBoundsException error message 
to be printed. 

# Only a reference to an array is passed to a method. That is, the array elements are not copied and passed 
to the method. Hence the individual elements of an array can be modified by a method passed as an 
array. 

|| Java allows arrays of any type, including arrays of arrays. With two bracket pairs, we obtain a two-dimen¬ 
sional array. This idea can be iterated to obtain arrays of higher dimension. With each bracket pair, we 
add another array dimension, as for example in 

doublet][] upUp; //two dimensions 

char[][][] andAway; //three dimensions 


Java has numerous container classes in the package java.util. One such container, ArrayLi st, acts as an 
arrray that can be grown dynamically. 



Review Questions 


1. Does the statement i nt [] x; create an array of integers? If you answer no, how do you create an array 
of integers and associate it with the variable x? If you answer yes , how many elements are in the array? 

2. Can you change the size of an array? Explain. 


3. Can you change the size of an Arraylist? Explain. 

4. Can an array variable be changed to refer to arrays of different sizes? What about arrays that contain dif¬ 
ferent types of primitive elements? 

5. Write a single statement that declares x to be an array of i nt values, creates an array of 10 integers, and 
assigns x to refer to the newly created array. 

6. What is the value of x [0] after executing the statement that answers the previous question? 

7. What is stored in s[0] after executing String [] s = new String[2j;? 

8. In a single statement, create an array of three Stri ng objects that contains the strings "one", "two", and 
"three”. 

9. Assume that x refers to an array of f loat values. Write a loop to print the values in x, one per line. Don’t 
make any assumptions about the length of the array. 

10. Java uses pass-by-value for all parameter passing. That is, a copy of the value of the variable or expres¬ 
sion is passed to the method. When the actual parameter is a primitive variable, the variable in the calling 
statement can’t be changed by the method. However, when passing an array variable, the contents of the 
array can be changed. What makes this change possible? 

11. What does the following code fragment print? 

int[] y = { 2 }; // create an array of length one 

mysteryCy); 
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System.out.println(y[0]); 

Assume mystery () is defined to be 

void mystery(int[] x) { 
x [0] = 1; 

} 

12. What does the following program print? 
class Reviewll { 

public static void main(String[] args) { 
int[] data = {1, 3, 5, 7, 9, 11}; 
int sum - 0; 

for (int i = 1; i < data.length; i++) { 
sum = sum + (data[i] + data[i - 1]); 

System.out.println(”sum = " + sum); 

} 

} 

} 

13. Convert each of the following expressions for running times of an algorithm to big-oh notation. 

3n + 2 

3 n + 21og n + 15 
256 n 2 + 19n+ 1024 

14. How many int values can be stored in the array created with new int[6] [5]? How many in new 
int[6][5][3]7 

15. What does the following code fragment print? 

int[] al = { 1 , 2 }; 
int[] a2; 
a2 = al; 
a2[0] - 3; 

System.out.println(al[0]); 

16. Is the following code fragment legal? If so, what does it print? 

int[] al = new int[3]; 
int[] a2 = new int[10]; 
al = a2; 

System.out.println(al.1ength); 

17. What does the following program print? 

class Reviewl6 { 

static int goo(int i){ 
return i + 2; 

} 

static void hoo(int[] d, int n) { 
for (int i =0; i < d.length; i++) 
d[i] - goo(n); 

} 
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public static void main(String[] args) { 
int i = 2; 

int[] a - {1, 2, 3}; 

System.out. pri ntl n( n goo =" + goo(i)); 
hoo(a, 1); 
hoo(a, i); 

for (i = 0; i < a.length; i++) 

System.out.println(i + " : " + a[i]); 

} 

} 

18. Why did we not use a for-iterator in writing hoo () in question 17? 
static void hoo(int[] d, int n) { 
for (int element:d) 
element = goo(n); 

} 



Exercises 


1. Modify the program Commandline in Section 5.12.1, Arrays of Strings, on page 150, to print the com¬ 
mand line arguments from right to left and to number each of them. 

2. Generalize the sieve algorithm in Section 5.9.1, Booleans: The Sieve of Eratosthenes , on page 135, to go 
from 2 through n. In the general case, you need only strike out multiples that are less than or equal to 
the square root of n. You also need only strike out factors for values that have not been set to false. For 
example, striking out multiples of 2 strikes out i sPrime[4]. Striking out multiples of 4 won’t strike out 
any elements not already out. Try to improve this program with these ideas. 

3. Allocate an array of integers of length 100. Initialize the array to a series of random numbers. Print the 
contents of the array. 

4. Repeat the preceding, but also find the minimum, maximum, and average value in the array. 

5. Repeat the previous exercise, but do not print the contents of the array. Instead use an array of length 
10,000 and write out how long each action on the complete array takes if you use the method Sys¬ 
tem . cu rrentTi meMi 11 i s (). This method returns a long integer that is the current time measured in 
milliseconds since midnight, January 1, 1970. By computing the difference between the time before and 
after an action you can determine how long the action took. Try this method for increasingly larger 
arrays by factors of 10 until your program no longer runs. That will happen when you request too large 
an integer array size from the heap. The heap is a place in the computer’s memory where all arrays are 
stored. 

6. A p alin drome is a sequence of words or characters that reads the same both forward and backward. 
Some examples are 

"otto" "121" "i may yam i" 

Write a method that takes an array of char and returns the boolean value true if the string is a palin¬ 
drome. 

7. Modify your palindrome function from the previous exercise so that blanks and capitals are ignored in 
the matching process. Under these rules, the following are examples of palindromes. 

'’Huh" "A man a plan a canal Panama” "at a" 

8. Write a different version of wordCount () that treats a word as a sequence of characters separated by the 
white-space characters: ' \t\ '\n',and '\b\ 
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9. Write a program that inputs a character array and then compiles as an array of strings all the individual 
words found. Use your instructor’s definition of word. 

10. Write a lexicographic comparison of two character arrays. 

static boolean isLess(char[] wordl, char[] word2) {. . .} 

//true if wordl < word2 

Words should be compared as in the dictionary, so be, bet, between, bird, . . . , are in correct order. You 
first must compare the character in the zeroth position. If two words are of different length and the 
shorter word is the same as the initial sequence of the longer word, then the longer word is greater. 

11. Write a routine that sorts character arrays lexicographically. Then modify Exercise 9 not only to capture 
the words, but also to print a sorted list of all the words found. 

12. Modify the previous exercise to produce a list of unique words independent of case. Turn all the words 
into lowercase before sorting them. After sorting them print only a single instance of any word. You need 
a test i sEqual () to readily accomplish this task, 

13. Write a program to produce the inner product of two arrays of double. Each array should be the same 
length. Write an overloaded form of this method that generalized it as follows. 

static double innerProduct(double[] vl, doublet] v2, 
int first, int last, double init); 

//vl and v2 must both have positions first and last 
//but can otherwise be of different lengths 
//init will normally be zero. 

14. A real polynomial p(x) of degree n or less is given by 

p(x) = a 0 + a±x + a 2 x 2 + • • ■ + a n ?^ 

with the coefficients oq , a h ..., a n representing real numbers. If a n ! = 0, the degree of p(x) is n. Polynomi¬ 
als can be represented in code by an array such as 

public final int N = 5; /* N is the max degree */ 
doublet] p = new doubletN + 1]; 

Write a method 

static double evalPoly(doublet] p, double x) { 


that returns the value of the polynomial p evaluated at x. Write two versions of the function. The first 
version should be a straightforward, naive approach. The second version should incorporate Horner's 
Rule. For fifth-degree polynomials, Horner's Rule is expressed as 

p(x) = a 0 + x{a x + x(a 2 + x(a 2 + x(a 4 + x(a s ))))) 

How many additions and multiphcations are used in each of your two versions of the eval Pol y () func¬ 
tion? 

15. Write a method that adds two polynomials. 

// f = g + h; 

static doublet] addPoly(double[] f, doublet] 9 ) { 


16. Write an algorithm to multiply two polynomials. Use your function addPolyQ to sum intermediate 
results. 
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17. This approach isn’t very efficient, so write a better routine, if you can, to do the same thing. Make use of 
the ArrayList container for this problem. 

18. Write a program that reads 10 characters Into an array. Then have it print out the letters of the array 
sorted in alphabetic order. 

19. Write a program using an ArrayList to read a list of words and then sort the resulting words in alphabetic 
order and print them out. 

20. Write a program that reads n letters into an array where n is read in. Then have the program remove 
adjacent letters that are duplicates. 

21. Write a program that reads n strings into an array where n is read in. Then have it print out the strings of 
the array sorted in alphabetic order. Perform the sort with a method 

static void sort(String[] names){...} 

22. A simple encryption scheme is to interchange letters of the alphabet on a one-to-one basis. This scheme 
can be accomplished with a translation table for the 52 lowercase and uppercase letters. Write a program 
that uses such a scheme to encode text. Write another program to decode text that has been encoded. 
This isn’t a serious encryption scheme. Do you know why? If you’re interested, learn about a more secure 
encryption system and then program it. 

23. Recall that simulations involving the repeated use of a random number generator to reproduce a proba¬ 
bilistic event are called Monte Carlo simulations (after one of the world's most famous gaming casinos). 
In this exercise, you are to find the probability that at least two people in a room with n people have 
birthdays that fall on the same day of the year. Assume that there are 365 days in a year and assume fur¬ 
ther that the chance of a person being born on each day of the year is the same. A single trial experiment 
consists of filling an array of size n with integers that are randomly distributed from 1 through 365. If 
any two elements in the array have the same value, then we say that the trial is true. Thus a true trial cor¬ 
responds to the case when at least two people in the room were bom on the same day of the year. Simu¬ 
late the probability by r unnin g, say, 10,000 trials with n people in the room. Do this for n = 2,3,..., 100. 
You can use the expression 


(i nt) (Math. randomQ * 365 + 1) 

to compute the day of birth for each person. The number of true trials divided by 10,000 is the computed 
simulated probability. What value of n yields the probability of at least 0.5 that there are shared birth¬ 
days in the room? 

24. Consider again the probability question in the previous exercise, but look for three people in a room of n 
people sharing the same birthday. By the way, if there are 2 * 365 + 1 people in the room, you are guaran¬ 
teed (forgetting leap day) to have a probability of 1 for this question. 


25. Two matrices can be multiplied, provided that the number of columns of the matrix on the left of the 
multiplication sign equals the number of rows in the matrix on the right of the multiplication sign. If the 
left matrix, call it L, has m rows and n columns and the right matrix, call it R, has n rows and p columns, 
then the result, call it X, will be a matrix that has m rows and p columns, with each element defined by 


m 



k = 1 


Write a method mul t () that takes two two-dimensional arrays of double values representing two matri¬ 
ces and returns the two-dimensional array that results from multiplying the two matrices. The method 
should return null if the matrices can’t be multiplied because the number of columns of the first 
doesn’t equal the number of rows in the second. 
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A key aspect of most current programming languages, and object oriented languages in particular, is the abil¬ 


ity of the programmer to create new types. In Java there are three kinds of types, primitive types like i nt and 
fl oat, arrays, and classes. The Stri ng type we have been using is one example of a pre-defined class type. 
Arrays and classes are both examples of reference types. They are called reference types because variables of 


these types store a reference or pointer to the actual data value rather than storing the data value directly in 
the variable as is done with primitive types. 


For class types, the actual data values are referred to as objects or instances of the class. They are called 
objects because they are often used to model objects in the real world. For example, a person might be repre¬ 
sented in a Java program as an instance of the class Person. Each instance of the Person class might store 
data that described a particular person storing their name, date of birth, and social security number The 
class Person would define what data was needed to represent each person. 


A class not only describes the particular data values that make up objects from the class, but they can also 
define how those objects can be manipulated. Unlike the primitive types which have special syntax for differ¬ 
ent operators such as + for addition and * for multiplication of numeric primitive types, operations on class 
types are defined as methods. In object-oriented terms, objects are defined to accept and respond to certain 
messages. For example, an instance of the class Person might respond to the message, getName by provid¬ 
ing the person’s name as a Stri ng value. In Java this “sending of a message to an object” is implmented as a 
method invocation. 


In Java, a programmer can create new types by creating new classes. We will begin our exploration of creating 
new types by exa min in g a specialized form of the class declaration called an enumeration. An enumeration is 
usually a small set of constant literals that have a strong relationship, such as the days of the week, a small 
set of colors, the suits from a deck of cards, or types of music. 



6.1 THE ENUMERATION TYPES 


9 

m 


An enumeration type is typically a small set of named values called enumerators. An example of such a type 
is the days of the week declared using the following declaration. 


public enum Days 
Sunday, monday 

} 


{ 

tuesday, Wednesday, thursday, friday, Saturday 
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This declaration creates a simple type with seven values. We will place this in the file Days.java, compile it, 
and then use Days in a separate program called TestDays.java. In that file, we have: 

//TestDays.java - Test enum Days of the week 
public class TestDays 

{ 

public static void main(String[] args) 

{ 

Days today = Days.monday; 

System.out.printlnC'Today is : " + today); 

} 

} 

This simple program prints “Today is : monday”. Why not just use integers or stings to represent the days? 
Two reasons are first, by creating a type, we improve documentation. It is clear what using the type Days 
means. Second, their is type safety that the compiler checks for us. We cannot inadvertently use some arbi¬ 
trary integer or string where we mean a day. 
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6.2 ENUM METHODS 


Enumerated types have some predefined methods or operations that can be performed on them. For exam¬ 
ple, one such method is ordi nal () that tells you the ordinal position of the enumerator. By default, the 
ordinal value of the first enumerator is 0. If in the previous code, we added the output statement 

System.out.println("enumerator position is: " + today.ordinal()); 

the program would print enumerator position is: 1. Why? Because monday is after Sunday and Sunday 
is position 0, so monday is position 1. 

We can add our own methods that perform computations with enumeration types. For example, here we have 
added a static method for computing the next day to our program TestDays. It is often convenient idiomati¬ 
cally to compute enumerated values using a switch-statement where each case is one of the enumerators. 

//TestDays.java - Test enum Days of the week 
public class TestDays { 

public static void main(String[] args) 

{ 

Days today = Days.monday; 

System.out.println("Today is : " + today); 

System.out.print!n("Tomorrow is : " + nextDay(today)) 

} 

static Days nextDay(Days day) { 
switch(day) 

{ 

case Sunday: return(Days.monday); 

case monday: return(Days.tuesday); 

case tuesday: return(Days.Wednesday); 
case Wednesday:return(Days.thursday); 
case thursday: return(Days.friday); 
case friday: return(Days.Saturday); 

default: return (Days.Sunday); 

} 

} 

} 


The output of our program is now: 







































Today is monday 
Tomorrow is tuesday 


6.3 instance methods 16 7 


Notice that enumeration values can be used in switch statements. Previously we indicated that only integral 
values could be used in switch statements. The Java compiler uses the ordi nal () instance method, which 
exists for all enum types, to convert enum values into integers. 
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6.3 INSTANCE METHODS 


The method ordinal() is an instance method that works on any variable declared as an enum. It is called in 
the form variable.ordi nal (). The result is that the ordinal position of the enumerator value stored in the 
variable is returned as the expression’s value. In effect the instance variable is an implicit argument to the 
method ordi nal (). Let us see how to code nextDay () as an instance method. It must appear inside the def¬ 
inition of the enum Days. 


//Days.java - Days of the week 
public enum Days{ 

Sunday, monday, tuesday, Wednesday, thursday, friday, Saturday; 


public Days nextDay() 


{ 

switch( this ) 

{ 

case Sunday: 
case monday: 
case tuesday: 
case Wednesday: 
case thursday: 
case friday: 
default: 

} 

} 

} 


return(Days.monday); 
return(Days.tuesday); 
return(Days.Wednesday); 
return(Days.thursday); 
return(Days.friday); 
return(Days.Saturday); 
return(Days.Sunday); 




Dissection of the class: Days 


# public enum Days{ 

Sunday, monday, tuesday, Wednesday, thursday, friday, Saturday; 

The values for the enum are listed in a comma separated list. In the earlier simple Days with no addi¬ 
tional methods, that was the entire enum definition. Note that here the list is terminated with semicolon 
The semicolon is required if methods are also defined for this enum. The indentifiers de fining the enum 
values (e.g. Sunday, monday, etc.) must imm ediately follow the open brace in the definition. 

• public Days nextDay() 

{ 

The code and logic is much the same as in our previous version. Notice that this method does not use 
the keyword stati c. This is an instance method. It can only be called with an implicit parameter that is 
an instance of the class Days. The method is invoked on the variable that it is dotted with, as in d. next- 
DayQ, where d was declared to be typd Days. 
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# switch( this ) 

{ 

case Sunday: return(Days.monday) ; 

The switch statement is switching on the implicit Day value that was used to invoke the method next- 
Day(). That implicit parameter is referred to using the keyword thi s, as shown here. Compare the 
switch statement defined here with the one in the earlier example oi a static method nextDayO. As 
mentioned earlier, the compiler automatically converts the value of type Day (or any enum) when used in 
a switch into an integer by c allin g ordinalQ. Somewhat more verbously, we could have written the 
switch like this: 

switchC this.ordinal() ) 




6.4 ENUMERATION OPERATIONS 


We have already used the enumeration method ordi nal (). Here is a short description in table form of some 
other enumeration operations. 


ENUM Method 

Purpose 

I.-:.. .. 3-U •: : 1.. 

•• .• • • •.. . 

V:>: 1 : 

int compareTo(E o) 

compares o to enumerator 

boolean equals (Object e) 

true: e equal to enumerator 

int hashCodeQ 

hash code for enumerator 

String name() 

name of enumerator 

int ordinal() 

position of enumerator 

static Iterator valuesQ 

use to iterate over enumerators 


We can use one of these methods to extend our enumerator type Days to tell us if a given day is on the week¬ 
end. 


First we write the i sWeekend () instance method inside Days. 
//Days.java - Days of the week 
public enum Days{ 

// omitted code should be the same as above 

• * ■ 

public boolean isWeekend() 

{ 


return (this.equals(Sunday) 


this.equals(satu rday)); 


} 


} 


The code to test this method is TestWeekend.java. 
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//TestWeekend.java - Test enum Days of the week 
public class TestWeekend 

{ 

public static void main(String[] args) 

{ 

for(Days d: Days.valuesQ) 

System.out.println(d.name() + " is on the weekend is " + d.isWeekendQ); 

} 

} 

The for iterator statement uses the enumerators in order of their position. Each print statement prints a sen¬ 
tence telling if that day falls on the weekend. 

So far we have shown how to create a basic enumerated type. 



6.5 A SIMPLEST CLASS 


A cl ass much like an enum can be used to produce a very simple data type that bundles one or more data 
values. As suggested earlier, suppose we want to have values in a program that represent different people. 
For each person we need to keep track of their name and their phone number. We can write such a data type 
as a class Person. 

class Person { 

String name; //data member or field 

String phoneNumber; //data member or field 

} 

The class declaration for Person can be thought of as a blueprint for creating instances of the program’s 
notion of a person. To actually create instances, we need to use the new operation 

Person p; //declare that p will refer to a Person object 
p = new Person(); // create a Person object 

or 

Person p = new PersonO; //declare and construct 

The variable p is a reference variable and has as its value a memory address. The operator new gets from the 
system memory, called a heap, the number of bytes needed to store everything we know about a Person 
object. The resulting value of p is the memory 7 address of where the data fields are stored. This is very anala- 
gous to declaring arrays. Recall an array name is a reference variable. 


6.5.1 MEMBER ACCESS OPERATOR 

We have already used the dot or member access operator in expressions such as wordl. concat (word2), 
d. nextDay (), and d .ordi nal (). It is a construct of the form 

classVariable.memberName 

When the member is a data member rather than a method member, the construct is used as a variable in the 
same way that a simple variable or an array element is used. Suppose we want to assign some values to the 
Person variable p is referring to. We can write 

p.name = "Jane Programmer"; 
p.phoneNumber = "(831) 459-1234"; 

System.out.println(p.name + '"s phone number is " + p.phoneNumber); 
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The member names must be unique within the class. However, each instance of a class will have its own copy 
of each data member. 

//same memberName different instances 
Person jane = new PersonQ; 

Person john = new PersonO; 
jane.name = "Jane Programmer"; 
john.name = "John Programmer"; 

We could also have a class Student declared as follows: 

class Student { 

String name; 
float gpa; 


Here again the use of the identifier name in class Student does not conflict the the identifier name in class 
Person. 

These simple classes are analagous to structures in the programming language C created using the struct 
keyword. Simple classes such as these allow a programmer to aggregate data fields into a single object. 

We could readily write static methods to manipulate these types. For example here is a program that contains 
a method for printing Person objects and a method that checks to see if two objects of the class Person 
refer to a person with the same name but possibly contain different phone numbers. 

// SameName.java - demonstration of class Pair 
public class SameName { 

public static void main(String[] args) 

{ 

Person personOne = new PersonO; 

Person personTwo = new PersonO; 
personOne.name = "Jane Programmer"; 
personOne.phoneNumber = "(831) 459-1234"; 
personTwo.name = "Jane Programmer"; 
personTwo.phoneNumber = "(651) 999-1234"; 
print(personOne); 
print(personTwo); 

if (sameName(personOne, personTwo)) 

System.out.println("They are the same person.”); 
el se 

System.out.println("They are different people."); 

} 

static void print(Person p) 

{ 

System.out.println(p.name + "'s phone number is " + p.phoneNumber); 

} 

static boolean sameName(Person p, Person q) { 
return p.name.equals(q.name); 

} 
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6.6 ADDING INSTANCE METHODS: CLASS Counter 


As discussed at the beginning of this chapter, a class describes the data values that make up an object from 
the described class and any operations that can be applied to that object. The data values are stored in 
instance variables , which are also called data members or fields. The operations are described by instance 
methods, which are also called procedure members. The examples Person and Student from the previous 
section had only data members. 

Typically, a class implements a user-defined data type needed to solve a progr ammin g problem. For example, 
suppose that we needed a class Counter that would count sequentially from 0 through 99. Each time the 
counter is “clicked” it should increase by 1. When the counter reaches 99 and is chcked it returns to 0. Such 
counters are common in everyday life: The sweep second hand on a watch is a counter that counts from 0 
through 59, and the trip odometer on a car is a counter. Our counter has values 0 through 99 and needs an 
operation click. We might also need to be able to reset the counter to 0 and to have a get operation that gets 
the current value of the counter. The following example uses our proposed Counter object. We then present 
the actual definition of the Counter class. 

// CounterTest.java - demonstration of class Counter 
class CounterTest { 

public static void main(String[] args) { 

Counter cl = new CounterQ; //create a Counter 
Counter c2 = new CounterQ; //create another 

cl.clickQ; // increment Counter cl 

c2.click(); // increment Counter c2 

c2.click(); // increment Counter c2 again 

System.out.printlnQ'Counterl value is " + cl.getQ); 

System.out.println("Counter2 value is " + c2.get()); 
cl. resetO ; 

System.out.pri ntl nQCounterl value is " + cl.getQ); 

} 

} 

The output of this program is 


Counterl value is 1 
Counter2 value is 2 
Counterl value is 0 


The methods clickQ and resetQ are mutator methods: They modify the values of the Counter objects 
upon which they operate. The definition of the class Counter is as follows. 


//Counter.java - 
class Counter { 
int value; 
void resetQ { 
int getQ { 
void clickQ { 

} 


a wrap around counter 

//0 to 99 

value - 0; } 

return value; } //current value 
value = (value + 1) % 100; } 
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Dissection of the class Counter 


| % class Counter { 

| The first thing to note about the class Counter is that there is no method mai n (). Counter by itself 
| isn’t a program. It is instead a class or new type that can be used in other java programs. As we showed 
| in CounterTest, we can declare variables of type Counter. 

| # int value; //0 to 99 

| Here we are declaring an instance variable. Each object or instance of the class Counter contains an inte- 
| ger used to represent the value of the Counter. Note that this variable declaration isn’t in the body of 
I any method. This variable is visible to all the instance methods of the class. 

I • void reset() { value - 0; } 

| This method is an instance method. Note that the keyword stati c is absent from this method defini- 
| tion. With the exception of nextDayO earlier in this chapter, the methods that we’ve been writing until 
I now have been static or class methods. Class methods don’t implement operations on objects. This 
I method appears to have no parameters and no return value. In fact it has one implicit parameter: the 
| object upon which this operation is being performed. That implicit parameter is the object named in the 
| method invocation—for example, cl in cl. reset (). This method demonstrates that the instance vari- 
| able val ue can be accessed from inside an instance method. 

| # int get() { return value; } //current value 

| This method is an accessor method. It simply returns the integer value that represents the value of the 
I Counter object. Again, the instance variable is referenced from inside an instance method. 

| # void clickQ { value = (value + 1) % 100; } 

I This method is another mutator method. It uses the modulus operator, %, to keep the value of the 
I Counter within the range 0 through 99. In general, including numbers such as the 100 in the statement 
I isn’t a good idea. The use of symbolic constants is preferable. We discuss symbolic constants in Section 
I 6.16, Keyword final and Class Constants , on page 180. 



Note that there is one instance of the integer variable value for each instance of the class Counter. In the 
program CounterTest, there are two copies of val ue: one for the Counter object referred toby cl and one 
for the Counter object referred to by c2. As discussed in the preceding dissection, in the method call 
cl. cl i ck (), the object referred to by cl is passed as an implicit first parameter to the method. In this way, 
the method knows which val ue to increment. 

The following diagram shows a portion of the computer’s memory just before the first two calls to 
pri ntl n (). By following the arrows, you can get from a variable such as cl to a particular object. From there 
you can find the methods for the class. 
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Local variables in mainQ Counter objects 


cl 

c2 



An abstract data type (ADT) is a user-defined type with a set of methods to manipulate objects of that type. 
In the case of Counter, we’ve methods such as get() and cl i ck(). There is also an implementation of the 
values needed to describe the object’s state—in this case, the instance variable val ue. Decoupling implemen¬ 
tation from manipulation via accessor and mutator methods has important advantages. For example, we can 
have a program use a Counter without knowing whether the internal value is represented as an i nt, 1 ong, 
byte, or possibly some other class. This capability allows the implementer to develop an optimal implemen¬ 
tation. At the same time it allows a client, or user of the implementation, the opportunity to develop an appli¬ 
cation using Counter without being concerned about the internal details of Counter. 

Note that in the preceding discussion we said the “object referred to by cl,” not “the object cl.” Recall that 
variables declared to be a nonprimitive type are referred to as reference variables. They don’t directly store 
the object but in fact store a pointer or reference to the object, as shown in the preceding diagram. However, 
when the fact that the variable is actually a reference is unimportant to the discussion, we say, “the object 
cl.” In Section 6.16, Keyword final and Class Constants , on page 180, we explain the circumstances under 
which it is important that the variable is actually a reference. 



6.7 ACCESS public AND private: DATA HIDING 


As a general rule, each class should be defined in a separate file. The name of the file should be the same as 
the name of the class with the suffix Java— for example, Counter.java. Many files with the .java suffix can 
reside in a co mm on directory. By default, all classes in the same directory are part of the same unnamed 
package. (We describe packages in Section 12.11, Packages, on page 380.) With appropriate syntax, methods 
for one class can refer to class variables, instance variables, class methods, and instance methods for any 
other class in the same package, provided that the variable or method declaration being referenced isn’t pre¬ 
ceded by the keyword private. For the example to work correctly, the files Counter.java and CounterT- 
est.java would need to be in the same directory and hence in the same unnamed package. 

Because the declaration of the instance variable val ue in class Counter isn’t preceded by the keyword pri - 
vate, any method in another class in the same directory can perform a manipulation, such as 

Counter c - new Counter(); 
c.value = 100; 

Such a manipulation isn’t consistent with our original description of Counter. In this case, the value isn’t 
between 0 and 99, inclusive. To prevent this from happening, we can declare val ue as pri vate. The pri - 
vate access modifier restricts the use of the variable to methods that are defined in the same class. Methods 
in other classes can’t use a privately declared variable. In data hiding terms, instance variables should be pri¬ 
vate to prevent misuse. Methods can be written to give access to the object’s values in a controlled and safe 
manner. 

Although we want to protect or hide the internal state of the Counter class, we want to be able to reuse the 
Counter class as widely as possible. That is, we want classes outside the current directory or package to be 
able to create Counter objects and manipulate them using the methods reset (), cl i ck(), and get (). We 
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can use the access keyword public to do so. This approach becomes more important as you begin to build 
your own packages. Until then, you won’t be able to observe any difference In behavior between public access 
and the default access when no access keyword appears. This is called package access. The class Counter is 
modified to include the preferred access modifiers as follows. 

// Counter.java - a simple wrap around counter 
public class Counter { 

//instance variables -fields -- hidden 
private int value; 

//methods -- exposed 

public void resetO { value = 0; } 

public int get() { return value;} 

public void clickQ {value = (value + 1) % 100;} 

} 

This Implementation makes certain access to the field val ue, such as the assignment c. value = 100, a 
compiler error if attempted from outside the methods in class Counter. The use of private fields for imple¬ 
mentation is a common technique in building ADTs and is referred to as the principle of data hiding. It 
enforces on the client or user of the ADT the discipline of using only the public fields and methods, also 
called the interface of the ADT. 



6.8 CONSTRUCTOR METHODS AND OBJECT CREATION 


When we want a Counter object we must allocate it with new, as in 
Counter cl = new CounterQ; 

This allocation creates a Counter object and calls a constructor, which initializes cl. val ue to 0 implicitly. 
The constructor in this example has an empty argument list; that is, there is nothing between the parenthe¬ 
ses in new Counter Q. This constructor is called the default, no-arg constructor. It is provided automatically 
by the compiler when it isn’t explicitly written by the progr amm er and no other constructors are defined. In 
the following program fragment, we provide Counter with two explicit constructors: one that initializes the 
counter with an integer value, and the second which is the no-arg constructor. 

public class Counter { 

//constructors 
public CounterQ { } 

public Counter(int v) { value = v % 100; } 


} 

A constructor is like a method with two special characteristics: It has no return type, and in place of an arbi¬ 
trary method name, has the class name. We don’t need to do anything in the no-arg constructor because the 
field value is automatically initialized to 0. All numeric fields are automatically initialized to 0, which is dif¬ 
ferent from local variables that are not automatically initialized. 

The constructor with the integer argument uses the argument to initialize the counter value. To ensure that 
the counter value is valid, based on our definition of a counter, we use the modulus operator. Its use guaran¬ 
tees that the value will be between 0 and 99, inclusive. 

The code in a constructor should stick to the purpose of initialization. In general, it should use its arguments 
as the means for initiahzing the instance variables of the object being created. Constructors are frequently 
overloaded because there are many useful ways to initialize objects. Overloading for constructors is the same 
as for methods. Recall that overloading allows us to write several methods with the same name, distin¬ 
guished by the number and types of their parameters. Our style is to group constructors at the head of the 
class definition. For initialization to work correctly, acceptable values must be used in the fields of the 
object. Good practice involves testing whether a value in the correct range is being used to initialize an 
object’s fields. For example, if our counter can only hold nonnegative values, we should verify that they are 
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initialized with values greater than or equal to 0. When we discuss exceptions in Section 11.1.6, Program Cor¬ 
rectness: Throwing an Exception , on page 335, we also use the constructor to check that the initial state is 
valid 


Common Programming Error 

Keep in mind that the default no-arg constructor is provided by the compiler only if no constructor is 
explicitly coded in the class. If we had added the constructor public Counte r (i n t v), but not the no- 
arg constructor, to our class Counter, then the declaration 

Counter cl = new CounterQ; 

would be a syntax error, generating a message similar to 

No constructor matching CounterQ found in class Counter. 



6.9 STATIC FIELDS AND METHODS 


The keyword stati c, as part of a method header, means that the method doesn’t have an implicit first 
parameter as we had when calling the methods of class Counter. We’ve made extensive use of static meth¬ 
ods as a way to organize simple programs. We’ve also used various static methods from other classes, such 
as Math. random() and Stri ng. val ueOf (). Note that, from outside the class in which it is defined, you call 
a static method by preceding the method name with the name of the class separated by a dot. 

Java also has static fields called class variables. A class variable is independent of the objects for the class. 
There is only one instance of a class variable no matter how many objects from the class you have created. 
The value Math. PI is a stati c or class variable in the class Math. Class variables are referenced just like 
class methods, by preceding the variable name with the class name. Some static fields are defined so that 
they can’t be changed, thereby turning them into constants. This is the case for Math. PI. 

For example, we can add a static variable to our Counter class to track how many counter instances have 
been created. 

public class Counter { 

//instance variables -fields — hidden 

private int value; 

private static int howMany = 0; 

//methods -- exposed 

public Counter(){ howMany++; } 

public void reset() { value = 0; } 

public int get() { return value; } 

public void clickQ { value = (value + 1) % 100; } * 

public static int howManyO { return howMany; } 

} 

Each time a Counter object is created, the stati c variable howMany is incremented. Unlike the field val ue, 
which can have a different value for each instance of Counter, the static field howMany is universal to the 
class. Here you can see some justification for the choice of the word stati c. A static field is created once, or 
statically , when the Java virtual machine first encounters the class. A new instance variable is created dynam¬ 
ically each time a new instance of the class is created with the operator new. The following test program dem¬ 
onstrates the difference between class variables and instance variables. 
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// CounterTest2.java - demonstration of static field 
class CounterTest2 { 

public static void main(String[] args) { 

System.out. printl n(Counter. howManyO) ; 

Counter cl = new CounterO; 

Counter c2 = new CounterO; 
cl.clickO ; 
c2.click(); 
c2 .click(); 

System, out .pri ntl n('’Counter 1 value is " + cl. get O) ; // value is 1 
System.out.println("Counter2 value is " + c2.get()); // value is 2 
System, out. pri ntl n (Counter. howManyO) ;// prints 2 

} 

} 

We modified CounterTest to print Counter . howManyO at the beginning and end of mai n(). The first 
statement prints out 0 because no Counter objects have been created and therefore the Counter construc¬ 
tor hasn’t been called to increment the variable howMany. The last statement prints 2 because the construc¬ 
tor for Counter was called twice, each time incrementing the static variable howMany in the class Counter. 
The following diagram is based on the one in Section 6.6, Adding Instance Methods: Class Counter , on page 
166, which illustrates this action. Here it has been modified to reflect the presence of the class variable how¬ 
Many when execution has reached the end of mai n () in CounterTest2. 



You can’t access instance variables directly or call instance methods from static methods. You can’t access 
instance variables from a static method because there is no object from which to get the variable. You can’t 
call instance methods using the methodName(argument-list) syntax because there is no object to pass as the 
implicit first parameter required by instance methods. But you can, of course, call instance methods by using 
variables that reference objects, as we did in CounterTest when calling cl. cl i ck(). The object referenced 
by cl will be the implicit first parameter to cl i ck (). 

For example, you would create a syntax error if you tried to reference the instance variable val ue from 
within the static method howMany (). The method howManyO when called with Counter. howManyO 
wouldn’t know which instance of value to use. The reason is that the method isn’t operating on any object. 

From within instance methods you can reference both static and nonstatic members (fields or methods) 
within the same class as the method. From wi thin the class in which a static member is defined, you normally 
access the member by specifying only its name, as for instance variables. 

We’ve now discussed all the concepts needed to explain fully the expression System, out. println(). Sys¬ 
tem is a standard Java class from the package java. 1 ang. The class System contains a static field named 
out, so System.out refers to the value stored in that static field. The value System, out is an object, or an 
instance, of the class Pri ntSt ream from the standard Java package java. i o. All you need to know for the 
current discussion is that the class Pri ntStream has an instance method pri ntl n(). So Sys¬ 
tem, out. pri ntl n() calls the pri ntl n() method associated with the Pri ntStream object referred to by 
the static field out in the class System, as illustrated in the followingdiagram. 
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Class System PrintStream object 


out 



Class PrintStream 


printlnO 

printO 


Common Programming Error 

A common mistake is to forget to use stati c for a variable that is referenced from within a method 
declared to be stati c. This error generates a message from the compiler similar to 

Attempt to reference a nonstatic variable from a static method. 

You’ll get a similar message if you attempt to call an instance method from a class method within the 
same class if you use only the name of the method. 
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6.10 CALLING METHODS—A RECAP 


There are three ways to call methods. How you call a method depends on two things: whether the method is 
an instance method or a class method, and whether the method is in the same class as the method contain¬ 
ing the call. 


6.10.1 CALLING A METHOD IN THE SAME CLASS 

The simplest form of method call has the form we used primarily in earlier chapters: methodNameCargu - 
ment-lisO . You simply give the name of the method followed by the actual argument list, as we did for all the 
methods we wrote in previous chapters. You can use this form to call one class method from another, to call 
one instance method from another, or to call a class method from an instance method. You can’t call an 
instance method from a class method in this way, even if the methods are in the same class. 

Recall that instance methods have an implicit first parameter that specifies the object to which the operation 
applies. For example, the method cl i ck() in class Counter needs to know “click what?” When calling one 
instance method from another, the same implicit first parameter is used. For example, we could have imple¬ 
mented the cl i ck() method in Counter by c allin g get (), as in 

void clickO { value = (get() + 1) % 100; } 

The call to get () will have the same implicit first parameter as the method cl i ck(). In this case both oper¬ 
ate on the same copy of the instance variable value. 

There is no implicit first parameter for class methods. Therefore any attempt to call an instance method 
from a class method, even in the same class, must provide the object that will be the implicit first parameter. 
The notation for calling an instance method from a class method is the same as calling an instance method 
of a different class. 
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6.10,2 CALLING INSTANCE METHODS 


To call a nonstatic or instance method in a different class we used, for example, wordl.concat(word2) to 
call the instance method concatC). The method concatO is defined, without the keyword stati c, in the 
class Stri ng, a different class from Hel 1 oWorl d2 where the call is located. The method name in this case is 
preceded by an expression that evaluates to a value from the class that contains the method definition. In the 
example given, wordl must evaluate to a value from the class Stri ng. A simple variable name is the most 


co 


■aias 


on expression used in this form, but any expression that evaluates to an appropriate value can be used. 
For example, we could write wordl. toUpperCase () . concat (word2) . In this case, the expression 
wordl. toUpperCase () evaluates to a value of type Stri ng. The method concat Q will be implicitly passed 
the Stri ng that appears before the name of the method in the call and explicitly passed word2. 


6.103 CALLING CLASS METHODS 

In Chapter 5, Arrays And Containers , all the methods we wrote were static or class methods. As explained in 
Section 6.10.1, Calling a Method in the Same Class , on page 171, when the call is from one method to another 
in the same class, we can simply use the name of the method. If the method is in a different class, we precede 
the name of the method with the name of the class. Superficially, doing so appears similar to calling an 
instance method. However, instead of preceding the name of the method with an expression that evaluates to 
a value from the class, we precede it with the name of the class. For example, we used Math . sqrt (x) to call 
the class method sqrt() from class Math. 



6.11 PROBLEM SOLVING: MAKING CHANGE 


Earlier we developed a simple program for making c hange. We can encapsulate the logic of that program in a 
class. The new class can then be used in a larger program for making change. 

We can look at change as an object returned when we have a purchase. We have to decide which data mem¬ 
bers are needed for making change. Generally, objects mimic the real world. In this case we need members 
that track the number of coins of each denomination. We also need actions that are useful with these types. 
For example, what would be the value of a set of coins containing three quarters and two dimes? 

//Change.java 

import java.util.Formatter; 
class Change { 

private int dollars, quarters, dimes, pennies; 
private double total; 

Change(i.nt dlrs, int qtr, int dm, int pen) { 
dollars = dlrs; 
quarters = qtr; 
dimes = dm; 
pennies = pen; 

total = dlrs 4- 0.25 * qtr + 0.1 * dm + 0.01 * pen; 

} 

static Change makeChange(double paid, double owed) { 
double diff = paid - owed; 
int dollars, quarters, dimes, pennies; 
dollars = (int)diff; 

pennies = (int)Math.round((diff - dollars) * 100); 

quarters = pennies / 25; 

pennies -= 25 * quarters; 

dimes = pennies / 10; 

pennies -= 10 * dimes; 

return new Change(do!1ars, quarters, dimes, pennies); 


} 














































6.11 Problem Solving: Making Change 7 73 


public String toStringQ { 

StringBuffer result = new StringBuffer(); 

Formatter out = new Formatter(result); 

out.format(”$%.2f%n%d dollars%n%d quarters%n" + "%d dimes%n%d pennies%n”, 

total, dollars, quarters, dimes, pennies); 
return result.toString(); 

} 

} 




Dissection of the Change Program 

• private int dollars, quarters, dimes, pennies; 
private double total; 


Here we declare the various data members bundled inside a Change object. We gave them private access 
to protect them from arbitrary manipulations by nonmember methods. 

• Change(int dlrs, int qtr, int dm, int pen) { 

dollars = dlrs; 
quarters = qtr; 
dimes = dm; 
pennies = pen; 

total = dlrs + 0.25 * qtr +0.1* dm +0.01* pen; 

} 

As currently defined, the only way to construct a Change object is by specifying the number of each type 
of coin. We chose not to use nickels or half-dollars, just to keep the code shorter. Because there’s no no- 
arg constructor in this class, we can’t create a Change object by using the expression new Change (). As 
discussed earlier, doing so would result in a syntax error. We intentionally left the no-arg constructor 
out because, as currently implemented, there is no use for it. 

• static Change makeChange(double paid, double owed) { 

double diff = paid - owed; 

int dollars, quarters, dimes, pennies; 

dollars = (int)diff; 

pennies = (int)Math.roundC(diff - dollars) * 100); 

quarters = pennies / 25; 

pennies -= 25 * quarters; 

dimes = pennies / 10; 

pennies -= 10 * dimes; 

return new Change(dollars, quarters, dimes, pennies); 

} 

This method is a static method because it isn’t operating on a Change object. Instead, it is a helper func¬ 
tion, used to compute change for an amount paid and an amount owed. Once we’ve computed the num¬ 
bers of each of the coin types, we then create a new Change object, using the values. This new Change 
object is then returned as the result of the method. Note that we are using an object to encapsulate 
many related values—the amounts of the various coins. The return type, rather than being a single prim¬ 
itive value, is an object. This type allows a complex calculation to bundle and return many related values 
as an object. 
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# public String toStringC) { 

StringBuffer result = new StringBuffer(); 

Formatter out = new FormatterCresult); 

out .format( T, $%.2f%n%d dollars%n%d quarters%n" + 

"%d dimes%n%d pennies%n", 
total, dollars, quarters, dimes, pennies); 
return result.toString() ; 

} 

As we demonstrate later, all classes Include a method toStri ng(), which returns a string representa¬ 
tion of the class. If we don’t provide the method, the Java system provides one by default—but it isn’t 
useful for most purposes. It simply returns the name of the class of which the object is an instance and 
the address of the object in the computer’s memory. One version of the method printinQ takes as an 
argument any reference. The method then prints whatever the toStri ng () method for the referenced 
object returns. Here we use a Stri ngBuffer and a java, uti 1 . Formatter object to build the result 
string. The format () method for Formatter works just like printfQ but can be used to format a 
string into a Stri ngBuffer as shown here. The format string %.2f says format the corresponding 
parameter as a floating point value with 2 digits to the right of the decimal point. The format string %n 
inserts a platform dependent newline into the result string. For more information about formatting with 
pri ntf () see Section 2.8.1, Formatting output with printfQ, on page 26. 



The following simple program uses the class Change. 

public class ChangeTest { 

public static void main(String[] args) { 
double owed = 12.37; 
double paid = 15.0; 

System.out.printf("You owe $%.2f%n", owed); 

System.out.printf("You gave me $%.2f%n", paid); 

System.out.println("Your change is " + Change.makeChange(15.0, 12.37)); 

} 

} 

The output of this program is 


You owe $12.37 
You gave me $15.00 
Your change is $2.63 
2 dollars 

2 quarters 
1 dimes 

3 pennies 



6.12 ACCESSING ANOTHER OBJECT’S PRIVATE FIELDS 


Using the abstraction capability provided by classes, you can easily make manipulating complex objects as 
easy as manipulating simple values. For example, you can easily modify the Change class from Section 6.11, 
Problem Solving: Making Change, on page 172, to support addition and subtraction of two Change objects. 
You do so by adding methods to support each of the operations. The following example shows how this new 
capability is used. 
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public class ChangeTest2 { 

public static void main(String[] args) { 

Change cl = new Change(10, 3, 4, 3); 

Change c2 = new Change(7, 2, 2, 1); 

Change sum = cl.add(c2); 

System.out.printIn(sum); 

} 

} 

After creating two sets of change, cl and c2, we add them, using cl. add (c2). The following method must 
be added to the class Change to implement this new operation. 

public Change add(Change addend) { 

Change result = new Change(dollars + addend.dollars, 

quarters + addend.quarters, 
dimes + addend.dimes, 
pennies + addend.pennies); 

return result; 

} 

The method simply creates a new object, initializing its data members to the sum of the corresponding mem¬ 
bers from the object upon which the method was invoked, cl in this example, and the parameter, c2 in this 
example. This new Change object is then returned as the result of the method. Note that this method, when 
invoked on one object, can access the private fields of another object from the same class. The implementa¬ 
tion details are hidden from other classes, but not from other objects in the same class. We leave adding a 
method for subtraction of Change values as Exercise 10 on page 189, for you to do. 

We could have created a static method with two explicit parameters, as in 

public static Change add(Change augend,Change addend) { 

Change result = 

new Change(augend.dollars + addend.dollars, 

augend.quarters + addend.quarters, 
augend.dimes + addend.dimes, 
augend.pennies + addend.pennies); 
return result; 

} 

Such a method, when called from another class, would have required including the name of the class in the 
call, as in 

Change sum = Change.add(cl,c2); 

Static methods don’t support the object-oriented model of “sending messages to objects.” Specifically, static 
methods don’t allow for dynamic method dispatch , which we discuss in Section 7.2, Overriding Instance Meth¬ 
ods , on page 197. As we show later, we can “send a message” to an object—that is, invoke a method—when 
we don’t know its exact type or class. The appropriate method is determined dynamically, which can be a 
powerful technique. 
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3 PASSING OBJECTS: REFERENCE TYPES 


In Section 6.12, Accessing Another Object’s Private Fields , on page 175, the method add () in class Change 
had a parameter that was type Change and also returned a value that was type Change. The syntax was iden¬ 
tical to the syntax used for passing and returning primitive type values. Despite the apparent similarity, 
there is one important difference. 

As discussed in Section 4.8, Invocation and Call-By-Value, on page 96, primitive values are passed using cab¬ 
by-value. In other words, the value of the actual parameter (the expression at the point of the method call) is 
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passed. In particular, we showed that, when the actual parameter is simply a variable, the value stored in the 
variable can’t be changed by the called method. 

Recall that variables declared with a class type are referred to as references. A reference variable doesn’t 
store an object directly but instead stores a reference to an object. This technique was shown graphically in 
the diagram in Section 6.6, Adding Instance Methods: Class Counter , on page 166. Consequently, when a refer¬ 
ence type variable is passed using call-by-value, the “value” passed is the reference, not the actual object. 

The result is that, when a reference type variable is passed to a method, the method receives a reference to 
the same object. This result in turn means that, if the referenced object is modified, the change will be 
observed back at the point of the call. The following program uses the class Stri ngBuffer to demonstrate 
this behavior. 

// PassingReferersces. java 

// object parameters can be modified 

class PassingReferences { 

public static void main(String[] args) { 

StringBuffer sbuf = new StringBuffer("testing"); 

System.out.printlnC’sbuf is now " + sbuf); 
modify(sbuf); 

System.out.printlnC’sbuf is now " + sbuf); 

} 

static void modify(StringBuffer sb) 

{ 

sb.append(", 1 2 3”); 

} 

} 

The output of this program is 


sbuf is now testing 
sbuf is now testing, 123 


This behavior is illustrated in the following diagram. The arrows indicate that the variables are referring to a 
Stri ngBuffer object. When modifyO is called, the value in the box labeled sbuf is copied to the box 
labeled sb. The values in the labeled boxes are the references to the actual object. When the append () 
method for the Stri ngBuffer is called the Stri ngBuffer object is changed. 
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Before the call to sb.appendC", 1 2 3") 
main() modifyO 



A StringBuffer object 


After the call to sb,append(", 1 2 3") 
main() modifyO 



A StringBuffer object 


If you t hink of the object as the parameter, this way of passing a parameter can be called call-by-reference. 
The reason is that a reference to the object is passed, not a copy of the object itself, as in call-by-value. How¬ 
ever, if you t hink of the variable as the parameter, this way of passing a parameter is properly referred to as 
call-by-value. The important thing to remember is that you can’t change the value stored in a variable for a 
primitive type as a result of being passed as a parameter to a method. However, you can change the object 
referred to by a variable for a reference type by passing that variable to a method. Also, you can’t modify the 
actual reference variable by passing it as a parameter. The following program emphasizes this distinction. 

// ModifyParameters.java - you can’t modify the actual 
// arg even when it is a reference 
class ModifyParameters { 

public static void main(String[] args) { 

StringBuffer sbuf = new StringBuffer("testing"); 

System.out.println("sbuf is now " + sbuf); 
modify(sbuf); 

System.out.println("sbuf is now " + sbuf); 

} 

static void modify(StringBuffer sb) { 
sb = new StringBuffer("doesn’t work"); 

} 

} 

The output of this program is 


sbuf is now testing 
sbuf is now testing 


The attempt to modify sbuf by making an assignment to sb in method modi fy () has no effect outside the 
method. To understand why, refer to the figure in Section 6.13, Passing Objects: Reference Types, on page 
176. Can you redraw the figure to show what it would look like immediately after the assignment of the new 
Stri ngBuffer to sb? Try 7 it. 
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6.14 SCOPE 

In Section 4.4, Scope of Variables, on page 86 we discussed the scope of local variables. Recall that the scope 
of a local variable starts at the point of declaration and continues to the end of the block containing the dec¬ 
laration. Class variables and instance variables also have a defined scope—that is, the range of statements 
over which the declaration is visible. 

The scope of both class variables and instance variables is the entire class, regardless of where the declara¬ 
tion appears. A local variable must be declared before its first use. In contrast, instance variables and class 
variables can be declared at the end of a class and still be referenced by methods defined earlier. For exam¬ 
ple, in the class Counter, we could place the declaration of the instance variable value at the end, as in 

class Counter { 

void resetQ { value = 0; } 

int get() { return value; } //current value 

void clickC) { value = (value + 1) % 100; } 

int value; //0 to 99 

} 

Note that we referenced val ue before defining it. We can do so because, as just stated, the scope of an 
instance variable is the entire class. 

When a local variable and a class variable or an instance variable have the same name, the local variable takes 
precedence and the class variable is hidden. A hidden class variable can still be accessed by using the quali¬ 
fied name of the class variable, which is the name of the class followed by a dot followed by the class variable 
name. A hidden instance variable can be accessed by using the keyword this. There is no way to refer to 
local variables from outside the method in which the local variable was declared. Consider the following pro¬ 
gram. 

//Scope2.java: class versus local scope 
class Scope2 { 

public static void main(String[] args) { 
i nt x = 2; 

System.out.println( M local x = " + x) ; 

System.out.println("class variable x = " + Scope2.x); 

} 

static int x = 1; 

} 

In this program the declaration where x = 1, declares a class variable, x. The scope of this variable is the 
entire class, even though it appears at the end of the class definition. This class variable could be referenced 
from any method defined in this class, not just mai n (). The declaration of x inside mai n () is a local vari¬ 
able. This declaration of x hides the class variable so that the first printlnQ prints local x = 2. The sec¬ 
ond printlnQ shows how the class name can be used to access the class variable when there is a local 
variable with the same name. If the local declaration of x was eliminated, the program would still be legal and 
both pri ntl n () statements would print the value of x as L 

As discussed briefly earlier with regard to enum declarations, the keyword this provides a reference to the 
implicit first parameter for instance methods—that is, the object upon which the instance method is operat¬ 
ing. For example, in a call such as cl. add (c2), the implicit first parameter to add () is cl, which can be ref¬ 
erenced with the keyword thi s inside the method. Let’s return to Change and recode some methods using 
the this reference. 
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Change(int dollars, int quarters, int dimes, int pennies) { 
this.dollars = dollars; 
this.quarters = quarters; 
this.dimes = dimes; 
this.pennies = pennies; 

total = dollars + 0.25 * quarters + 0.1 * dimes + pennies; 

} 

In our earlier definition of the constructor for Change, we had to make up alternative names for the formal 
parameters to avoid having them conf lict with the names of instance variables. The result of this approach is 
often that either the instance variable or the formal parameter have an unnatural choice of identifiers for a 
name. However, by using the thi s reference, we can use the most descriptive name for both. 

We can always add the thi s reference to an instance variable reference from within an instance method, but 
we normally do so only when necessary 7 to resolve an ambiguity. Without the this reference, we would have 
to find alternative names or be unable to access the instance variables. 

Later we show that there are other situations in which we need the this reference. In those situations, there 
is no alternative, such as renaming local or instance variables. That occurs when, from within an instance 
method, we need to pass a reference to thi s object to some other method. Without the this reference we 
couldn’t pass the current object to another method. 
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6.15 NESTED CLASSES 


Java allows for the definition of one class to be nested inside of another class. In its simplest form, a nested 
class is simply a convienient way of grouping two or more classes together into a single unit or module. This 
makes sense when one of the classes is clearly subordinate to the other and the subordinate class is of little 
or no use without one or more instances of the primary class. 

Consider the following simple linked list implementation. In this example, the Li stEI ement class is nested 
inside of the MyLi st class. Furthermore the nested class is private because the users of the MyLi st class 
have no need to know about or access the Li stEI ement objects directly. 

class MyList { 

private ListElement head, tail; //Forward declaration 
void add(Object value) { 
if (tail != null) { 

tail.next = new ListEIement(value); 
tail = tail.next; 

} 

else { 

head = tail = new ListElement(value); 

} 

} 

Object remove() 

{ 

assert head != null; // don't remove on empty list 
Object result = head.value; 
head = head.next; 

if (head == null) { //was that the last? 
tai1 = nul1; 

} 

return result; 


} 
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//Nested class needed only in the implementation of MyList 
private class ListElement { 

ListElement(Object value) {this.value = value;} 

Object value; 

ListElement next; //defaults to null as desired 

} 

} 

With this definition of My Li st, we can change the implementation entirely without affecting clients of the 
My Li st class. 



6.16 KEYWORD final AND CLASS CONSTANTS 


As suggested earlier, making the instance variables in a class pubhc is generally not a good idea. A better 
approach is to provide accessor methods and keep the actual instance variables hidden. Doing so allows us 
to be sure that the instance variables aren’t set in such a way as to compromise the correctness of the class. 
For example, we made val ue private in our Counter class so that we could be sure it was always between 0 
and 99, inclusive. There is one situation when instance variables are commonly made public: when the 
instance variable represents some constant value for the class. 

An example from a standard Java class is the value Math . PI, which is a class constant. In the class Math, this 
constant is declared, as in 

public static final double PI = 3.14159265358979323846; 

The keyword f i nal indicates that this variable can’t be changed once it has been initialized, effectively mak¬ 
ing it a constant. Any further attempt to make an assignment to Math . PI will result in an error message 
from the compiler. 

As a matter of style, such final values, or constants, are generally given identifiers that are all uppercase let¬ 
ters. Embedded words are separated with the underscore. For example, Integer. MAX„INT is a constant in 
the class Integer, which defines the largest possible integer value. 

In addition to providing helpful values such as Math. PI and Integer .MAX„INT, constants can also be used 
to make a program easier to modify and understand. In general, numeric literals shouldn’t be scattered 
throughout a program. Such numeric literals are often referred to derogatorily as “magic numbers.” Someone 
reading the code might see such a number and wonder, Where did that number come from? By turning the 
numbers into named constants, the program becomes self-documenting and all uses of the particular value 
can be changed by just changing the definition of the constant. To illustrate, we replace the magic number 
100 in our earlier example of the Counter class. 

class Counter { 

int value; //0 to MODULUS-1 

void reset() { value = 0; } 

int get() { return value; } //current value 
void click() { value = (value + 1) % MODULUS; } 
private static final int MODULUS = 100; 

} 

In this very short example, using 100 directly might seem fine. However, when the class becomes more com¬ 
plicated, we may find other methods using the modulus value of 100. For example, we might add a method to 
set the value or a constructor to give it an initial value. In either of those situations, we would still want to be 
sure that the value was properly in range. Using a constant makes the code easier to read and lets us easily 
change the modulus to something else. 
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6.1 7 ARRAYS OF OBJECTS 


Let’s assume that we want to write a program to play poker. One object we would want is a playing card. 
Once we had a playing card we could create a deck by having an array of 52 cards properly initialized. In this 
chapter we’ve avoided using arrays because we wanted to make the study of arrays and classes independent. 
If you haven’t yet read Chapter 5, Arrays And Containers on arrays you may want to skip this section until 
you do. 

Each card has a rank from 1 through 13, where 1 stands for ace, 11 stands for jack, 12 stands for queen, and 
13 stands for king. A card also has a suit value of clubs, diamonds, hearts, or spades. We use a number of 
classes to develop this apphcation. First we present a class encapsulating suit information. 

//Suit.java - a playing card attribute 
enum Suit { 

clubs, diamonds, hearts, spades; 

Suit next() { 
switch(this) { 

case clubs: return diamonds; 
case diamonds: return hearts; 
case hearts: return spades; 
default: return clubs; 

} 

} 

} 

Note how for this type we use an enum to represent the four card suits. We have included a next () method to 
allow for cycling through the possible suit values. 

We use the next class to represent card values. These are the card values 2 through 10 and the special cards, 
jack, queen, king, and ace. The card values are often referred to as the rank so we name the class Rank. 

//Rank.java - a playing card attribute 
enum Rank { 

joker, ace, two, three, four, five, six, seven, 
eight, nine, ten, jack, queen, king; 

Rank next() { 

switch(ordinal()) { 


case 

0: 

return 

ace; 

case 

1: 

return 

two; 

case 

2: 

return 

three; 

case 

3: 

return 

four; 

case 

4: 

return 

five; 

case 

5: 

return 

six; 

case 

6: 

return 

seven; 

case 

7: 

return 

eight; 

case 

8: 

return 

ni ne; 

case 

9: 

return 

ten; 

case 

10 

return 

jack; 

case 

11 

return 

queen; 

case 

12 

return 

ki ng; 

default 

return 

joker; 


} 

} 


} 


































182 


Objects: Data Abstraction 


Many decks of playing cards also include two special cards called jokers. We include jokers at ordinal posi¬ 
tion 0 which has the nice effect of making the result of ordi nal () for our Sui t type be the same as the nor¬ 
mal card value - e.g. 1 for ace and 13 for king. Notice that in the Rank class we have chosen to use ordi nal () 
and integer switch values rather than thi s and the symbolic enum values we used in Sui t. We did this 
because of the natural relationship between the ordinal value and the symbolic enum value. A playing card 
combines a suit value with a rank or card value. Note how, by properly mimicking the problem domain, we 
quickly develop a set of objects that allows us to represent card play easily. 

//Card.java - a playing card 
class Card { 

Suit suit; 

Rank rank; 

Card(Suit s, Rank r) { suit = s; rank = r; } 

Card(Card c) { suit = c.suit; rank = c.rank; } 
public String toStringO { 
return rank + + suit; 

} 

} 

A deck of cards, without jokers, is 52 individual cards of the right suits and ranks or card values. Here’s 
where arrays of objects prove useful. 

//Deck.java - a deck of playing cards 
class Deck { 

Card[] deck; 

DeckQ { 

deck = new Card[52]; 

Suit suit = Suit.spades; 

Rank rank = Rank.ace; 

for (int i = 0; i < deck.length; i++) { 
if (i % 13 == 0) { 
suit = suit.nextO ; 
rank = Rank.ace; 

} 

deck[i] = new Card(suit, rank); 
rank = rank.next(); 

} 

} 

void shuffleO { 

for (int i = 0; i < deck.length; i++){ 
int k = (int)(Math.random() * 52); 

Card t = deck[i]; 
deck [i] = deck[k]; 
deck[k] = t; 

} 

} 

public String toStringO { 

String t - ,,n ; * 
for (int i = 0; i <52; i++) 
if ( (i + 1) % 4 == 0) 
t = t + deck[i] + "\n"; 
else 

t = t + deck[i] + " M ; 
return t + M \n"; 

} 

} 

Two important methods in this class are the constructor, which must correctly initialize all the playing cards, 
and the shuffling method, which must reorder the cards in the deck. We focus on these routines in the dis¬ 
section of the class Deck. 
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Dissection of the Class Deck 


• Card[] deck; 

The internal representation of a deck is an array of cards, which is a natural representation. An under¬ 
standing of how the various classes build on each other is important. We use Suit and Rank to define 
Card. 

• DeckQ { 

deck = new Card[52]; 

Suit suit = Suit.spades; 

Rank rank = Rank.ace; 

for (int i = 0; i < deck.length; i++) { 
if (i % 13 == 0) { 
suit = suit.nextQ ; 
rank = Rank.ace; 

} 

deckfi] = new Card(suit, rank); 
rank = rank.nextQ; 

} 

} 

The deck, without jokers, is constructed of 4 suits of 13 cards each. We use the integer arithmetic opera¬ 
tors to ensure that all the distinct 52 cards are created. After a call to this constructor, the first card in 
the deck is an ace of clubs. The clubs are created in sequence, then diamonds, hearts, and finally spades 
with the card deck [51] being the king of spades. 

• void shuffle() { 

for (int i = 0; i < deck.length; i++) { 
int k = (int)(Math.random() * 52); 

Card t = deck[i]; 
deck[i] = deck[k]; 
deck[k] - t; 

} 

} 

We used the random number generator to rearrange a card deck. The following pseudocode describes 
this shuffle. 

Pseudocode for shuffle() 

randomly select one card from the deck 
and swap it with the first card 
randomly select another card from the deck 
and swap it with the second card 
continue until this has been done 52 times 
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HI public String toStringC) { 

String t = ""; 

for (int i = 0; i < 52; i++) 
if ( (i + 1) % 4 = 0) 
t = t + deck[i] + "\n"; 
else 

t = t + deck[i] + " 
return t + "\n"; 

} 

Recall that every class has a toStri ng() method. If one isn’t defined explicitly, a simple toStri ng() 
method is provided automatically via inheritance. (We describe inheritance in Chapter 7, Inheritance.) It 
converts the user-provided class type to a string. Among other uses, toStri ng () is used by pri ntl n () 
to generate an output representation. The i f statement is used to generate a newline for each four card 
values. In the expression t + deck [i ], the string representation of the card deck [i ] is implicitly gen¬ 
erated, using toStri ng () from class Card, before concatenation to t happens. 



We test these classes as follows. 

//CardTest.java testing the shuffling method, 
public class CardTest { 

public static void main(String args[]) { 

Deck deck = new Deck(); 

System.out.println("\nNew Deck\n" + deck); 

deck.shuffleO; 

System.out.println( M \nNew Shuffle\n" + deck); 
deck.shuffleQ ; 

System.out.println("\nNew Shuffle\n" + deck); 

} 

} 

Observing how well the shuffling method works by checking the results of successively shuffling the deck is 
important. This method should approximate the common real-world experience of shuffling and dealing a 
deck of cards. 



6.18 OBJECT-ORIENTED DESIGN 


Object-oriented programming (OOP) is a balanced approach to writing software, with data and behavior pack¬ 
aged together. This encapsulation creates user-defined types, which extend and interact with the native types 
of the language. Type-extensibility is the ability to add user-defined types to the language so that they are as 
easy to use as native types. 

An abstract data type such as a string is a description of the ideal public behavior of the type. From the doc¬ 
umentation of the class Stri ng, the user knows that operations, such as determining whether two strings 
are equal or converting a string to uppercase, are public behaviors supported by the class. These operations 
are implemented by the methods equal s() and toUpperCaseO from class String. Encapsulation is the 
ability to hide internal detail while providing a public interface to a user-defined type. Java uses class decla¬ 
rations in conjunction with the access keywords pri vat e and public to provide encapsulation. 

Object-oriented programing terminology is strongly influenced by the Smalltalk program min g language. The 
Smalltalk designers wanted progr amm ers to break with their past habits and embrace a new progra mmin g 
methodology. They invented terms such as message and method to replace the traditional terms function 
invocation and member function. 
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Public members are available to any function within the scope of the class declaration and provide the type’s 
interface. Private members are available for use only by other member functions of the class. Privacy allows 
the implementation of a class type to be hidden, which prevents unanticipated modifications to the data. 
Restricted access, or data hiding , is a feature of OOP. 

The design of object oriented-programs can be aided by a diagramming process. Several object-oriented 
design (OOD) notations exist, and a number have been incorporated in computer-aided software engineering 
tools (CASE). The most comprehensive diagramming process is based on the Universal Modeling Language 
(UML) pioneered by Rational Software. We will show a few examples of UML diagrams, with brief explana¬ 
tions, in subsequent chapters. Below we describe a related low-tech scheme that we’ve found useful. It is 
based on class-responsibility-collaborator (CRC) cards. 

A responsibility is an obligation that the class must keep. For example, the designer of the class Rectangle, 
from the standard package j ava. awt, decided that this class had the responsibility to provide a method that 
could be used to determine whether a rectangle “contains point p.” Likewise, our class Counter has the 
responsibility to provide a method to “click the counter.” 

A collaborator is another class that cooperates with the class represented by the CRC card. For example, the 
class Rectangl e must collaborate with the class Poi nt to provide the “contains point p” method. However, 
the collaborator relationship isn’t necessarily symmetric. For example, the CRC card for Poi nt might not list 
Rectangle as a collaborator. The collaboration between Point and Rectangle is important only to the 
Rectangle class. 

An index card or piece of paper is used to represent each class being developed.jlf the information can’t be 
made to fit easily on a single card or page, the class is too complicated and the design needs to be modified^ 
The name of the class, the responsibilities of the class, and the collaborators for that class are arranged on 
the front of the card. The back of the card can be used to describe implementation details. The front of the 
card corresponds to public behavior. 

As the design process proceeds, the cards are rewritten and refined. They gradually become more detailed 
and closer to a set of methods. The attractiveness of this scheme is its flexibility and simplicity. 

The design process begins by identifying the most obvious classes needed for the program and creating a 
CRC card for each. Next, various scenarios are proposed. Each scenario is designed to answer one or more 
“what-if” questions. As the scenarios are followed, existing CRC cards are modified and new cards are cre¬ 
ated. 

As an example, let’s consider of the design of a simple e-mail program. We begin by displaying a menu of 
options. The options include reading an existing e-mail message or sending a new message, as shown in the 
Mai nWi ndow CRC card. 


MainWindow 


Display main menu 

Read mail 

Send new message 



Collaborators 



EmailSender 

EmailReader 



The Emai 1 Reader class is responsible for retrieving e-mail messages from the e-mail server and then display¬ 
ing either the headers of all messages or the text of a single message. Each message is represented by an 
instance of the class Message. The class Emai 1 Server handles actual communication with the e-mail server. 
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EmailReader 

Display headers 

Display a selected message 

Get e-mail messages from server 



Collaborators 

Message 

EmailServer 




The Emai 1 Sender class is responsible for creating and sending a new message. It must allow for the editing 
of all the fields of a message. The actual transmission of the message to the e-mail server is handled by the 
EmailServer class. 


EmailSender 


Col 1aborators 



Send 
Edi t 
Edi t 
Edi t 
Edit 


the completed message 
message text 
message subject 
message "to" Field 
message "cc" list 



Message 
Emai1 Server 



Each e-mail message is represented by an instance of class Message. 


Message 

Get/set subject 
gEt/set to 
Get/set cc 
Get/set text 



Collaborators 



None 



At this point we examine usage scenarios to determine whether new classes are needed or whether existing 
classes need modification. For example, what if the user is reading a message and wants to send a response? 
The subject and to fields should be filled in automatically. In addition, quite often the user will want to 
include part of the original message in the response. One solution would be to add the responsibility of “cre¬ 
ate an initial response message” to the Emai 1 Sender class and add the responsibility of “respond to selected 
message” to the Emai 1 Reader class. 
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6.19 PROGRAMMING STYLE 


We prefer to write our Java classes with public members first and private members last. Applying this so- 

called need to know rule inserts first what everyone uses and needs to know and inserts last what only the 
implementers need. 

public class Counter { 

//public members - the interface to the class first 
//constants first then constructors then methods 
//overloaded methods are together 
public static final int MODULUS - 100; 
public CounterO { howMany++; } 
public Counter(int v) { 
value - v % MODULUS; 
howMany++; 

} 

//methods are alphabetical 

public void click() {value = (value + 1) % MODULUS;} 
public int get() { return value;} 
public static int howManyO { return howMany; } 
public void reset() { va~iue = 0; } 

//private members - implementation 
private int value; 
private static int howMany = 0; 



Summary 


• A 11 object is an instance of a class. In Java, objects are normally created by the use of new. A class can 
have both instance variables, called fields, and methods. Instance variables are used to describe the value 
or state of an object, and the method members are the operations that can be applied to the object. 

• Methods that access only the state of an object are called accessor methods. Methods that modify the 
state of an object are called mutator methods. 

• A class can have both static and nonstatic methods. Nonstatic methods are invoked as 
reference, method ( parameters') 


except when calling the method from another nonstatic method in the same class. In that case the object 
reference value reference can be dropped. In this latter situation, the this reference for the called 
method is the same as the this reference for the method making the call. 

An abstract data type (ADT) is a user-defined type with a set of methods to manipulate objects of that 
type. In the case of Counter, these methods include get () and cl i ck(). Public behavior is the interface 
of the ADT. There is also an implementation, usually private, of the values needed to describe the 
object’s state. In the Counter example, we made the field va] ue private. In ADTs, we decouple imple¬ 
mentation from manipulation. 
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# A constructor is used to create a class instance. Constructors have two special characteristics: They have 
no return type, and they have, in place of a method name, the class name. One further rule to keep in 
mind is that the default no-arg constructor is provided by the compiler only if no constructor is explicitly 
coded in the class. 

# The keyword this provides a self-reference within a method to the object that the method acts on. 
Unless needed in referring to members to avoid confusion with other names or to pass this object as a 
parameter to some other method, the keyword this is usually omitted. 

<p The keyword static as part of a method header means that the method doesn’t act on an implicit 
object. In other words, the method can’t use the thi s reference. In previous chapters, we made extensive 
use of static methods in organizing simple programs. 

U Java also has static fields or class variables. A static field isn’t duphcated in each instance of a class. 
There is just one instance of a static field, which is shared by all parts of the program that can access it. 



Review Questions 


1. Does the statement Stri ng s; create a Stri ng object? 

2. If you answered no to Question 1, how can an object be associated with the variable s? 

3. What is meant by the default constructor? 

4. Write a default constructor for class Counter that sets val ue to the largest possible i nt that is consis¬ 
tent with the specification of Counter. Why is the text’s default constructor preferable? 

5. What is meant by an accessor method? What is meant by a mutator method? 

6. Give an example from this chapter of data biding. 

7. What is meant by the interface to a class? 

8. Another term for a static field is a(n)_variable. Another term for a nonstatic field is a(n)- 

variable. 

9. How is a static field different from a nonstatic field? Can a nonstatic field be referenced without direct or 
indirect reference to an object? 

10. How can the this reference be used? Give an example where, in a class member, it is necessary to use 
the this reference. Briefly explain the conditions that require the use of thi s. 



Exercises 


1. Change and test i sPal i ndromeQ in Section 5.14, Problem Solving: Palindromes, on page 152, to return 
true even when letters are of different case. Therefore "eyE" would still be a palindrome. 

2. Change the isPalindrome program in Section 5.14, Problem Solving: Palindromes, on page 152, to 
ignore space characters. Therefore "e Ye" would still be a palindrome, or "A man a plan a canal 
Panama" would also be a palindrome. 
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3. Write a recursive form of the i sPal i ndromeO method in Section 5,14, Problem Solving:Palindromes, on 
page 152. 

4. Add the method increment(int i)to the class Counter in Section 6.19, Programming Style , on page 
187. The method adds i to the internal counter value. It must use the % modulus operation to guarantee 
a legal value in the field value. Write a program to test your modified Counter class. 

5. Add a method toStringQ to the class Counter in Section 6.19, Programming Style , on page 187. The 
method should convert a counter value to a string for output. You will need to declare the method pub- 
1 i c. Write a program to test your modified Counter class. 

6. Add a constructor to the class Counter in Section 6.19, Programming Style , on page 187, that takes two 
parameters. The first parameter is an i nt that specifies the intial value for the counter. The second 
parameter is an i nt that specifies the modulus for the counter. 

7. Create a class to represent a pair of integer values. The no-arg constructor should leave both integers at 
the default value of 0. Include a constructor that can take one value n , setting one of the values of the 
pair to n and the other to 0. Include a constructor taking two values, setting both values of the pair. Note 
how useful it is to design a set of overloaded constructors that conveniently initialize the object pair. 
Have accessor methods that return fi rst and second, the two values of the pair. Also have mutator 
methods that allow you to change the two values of a pair separately. Write a program to test your new 
class. 

8. Write a method minMaxO that takes as input an array of integers and returns the minimum and the 
maximum value in the array. The method should return the two integers by using the integer pair class 
from the previous exercise. Write a program to test your method. 

9. Create a class Rectangle that represents a rectangular region of the plane. A rectangle should be 
described using four integers: two to represent the coordinates of the lower left comer of the rectangle, 
giving its location; one for the width; and one for the height. Your rectangle class should include 

# appropriate constructors, 

m atoStringO method, 

% a method t ran si ate() that takes two integer parameters, del taX and del taY, used to trans¬ 
late the location bf the rectangle, 

# a method contai ns () that takes two integer parameters, xCoord and yCoord, and returns true 
if the point (xCoord, yCoord) lies within the rectangle, and 

H a method i ntersecti on() that takes a Rectangl e as a parameter and returns a new Rectan- 
gle that forms the intersection of the Rectangle upon which the method is operating, and the 
Rectangle parameter. 

Write a program to test the class Rectangle. 

10. Add a method sub() to the Change class in Section 6.11, Problem Solving:Making Change , on page 172. 
The method should be an instance method with one Change object as a parameter, returning a new 
Change object as the result. This method is similar to the add() method discussed in Section 6.12, 
Accessing Another Object’s Private Fields , on page 175. Write a program to test the new method. 

11. Rewrite the class Change in Section 6.11, Problem Solving: Making Change , on page 172, to include half- 
dollars and nickels. Include a toStri ng () method appropriate to this class. 

12. Write a MyStri ng class that mimics the behavior of the standard class Stri ng. To do so you should have 
already studied arrays. Use a private array of characters to implement this class. 

13. Code the class Cl ock. It is to have a set of methods that let you keep time. You want to be able to initial¬ 
ize a Cl ock to a given time in hours, minutes, and seconds. Include a method ti ck 0 that advances the 
Cl ock one second. Also include the ability to add two Cl ock values. When you add two Cl ock values, 
the first value will represent a time of day and the second will represent a time interval. Thus 2:15 plus 
1:30 is 3:45 or one hour thirty minutes later than 2:15. Use 24-hour time so that midnight is hour 0 and 
noon is hour 12. Include a method toStri ng () for output. 
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14. Recode Clock from the previous exercise to have a clock display time in terms of am/pm. How much of 
the previous implementation did you retain? Keep all these examples in mind when you read about 
inheritance (Chapter 7, Inheritance) as a way to reuse and factor code. 

15. Create a class to represent complex numbers. Complex numbers have two parts: a real part and an imag¬ 
inary part. So a complex number value could be (1,1.5 z), where 1 is the real part and 1.5/ is the imaginary 
part. You should be able to add, subtract, and multiply two complex numbers. The rules for these opera¬ 
tions are 

(a, bi) + (c, di) = (a + c, (b + d)i); 

(a, bi) - (c, di) = (a - c, (b- d)i); 

(a, bi) x (c, di) = (ac - bd, (ad + bc)i) 

Hint: The add () method in your class Compl ex should be like the one with one explicit parameter not 
like the static method with two exphcit parameters in Section 6.12, Accessing Another Object's Private 
Fields , on page 175.. 

16. Develop a class Person. It should have fields for first and last name, address, social security number, 
and telephone number. Be careful in your choice of types for each field. The address field should itself be 
an ADT defined as class Address. 

17. Create a class Hand that represents a hand of cards. Add a method deal HandQ to the Deck class inSec- 
tion 6.17, Arrays of Objects, on page 182, that deals a hand of 7 cards from a card deck. If you’ve read 
Chapter 5, Arrays And Containers , use an array of Card objects to implement the class Hand. Otherwise, 
you can include seven instance variables, one for each of the seven cards. 

18. Add a method isflushQ to the class Hand from the previous exercise. The method should return a 
boolean value. The result should be true if the hand has five cards of the same suit. Use this method to 
compute the probability of getting a flush by dealing out 1000 hands and computing how often a hand is 
a flush. 

19. Use the ideas from the previous problem to produce the probability of getting a straight. A straight is a 
sequence of five cards with successive rank values. Note that an ace can be either before a 2 or after a 
king. 

20. Write a program to play the number guessing game described in Section 5.7, Searching an Ordered 
Array , on page 133. Instead of using an array of length 2 to represent the range, use the class that you 
created in Exercise 7 on page 189, and call the class Range. In this way you can have methods such as 
ad justRangeC) that return a new Range object. 

21. Create a class Pol ynomi al. A polynomial has the form 

* ■ i 

aj • x 1 + a { _i ■ x 1_ 1 + • * • + aj • x + a 0 

You should represent a polynomial as an array of coefficients. Your class should include a constructor 
that takes an array of coefficients as a parameter, a method to evaluate the polynomial at a particular 
point, and a toStri ng() method. 

22. Add an add () method to the Pol ynomi al class that you created in the previous exercise. This method 
will take one Pol ynomi al as a parameter and return a new Polynomial that is the result of adding the 
Polynomial upon which the add() method was invoked and the parameter. 

23. Add a method f i ndRoot () to the Pol ynomi al class that you created in the previous exercise. The fi n- 
dRoot () method should be passed two parameters that correspond to the left and right ends of the 
interval in which to search for a root. The method can assume that the values of the polynomial at the 
two endpoints differ in sign. That is, if the value of the polynomial at one end is positive, the value of the 
polynomial at the other end must be negative. From the Mean Value Theorem we know that the polyno¬ 
mial must cross the x axis somewhere in the interval. That point is a root of the polynomial. The follow¬ 
ing is a simple root-finding algorithm. 
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Pseudocode for Finding the root of a polynomial 


assume a and b are the endpoints of the interval 
assume p is the polynomial to be evaluted 
while the absolute value of (a - b) > epsilon 


root = (a + b) / 2 // guess the midpoint 

error = p(root) // how close to 0 are we 


if (error > 0) 

set the positive endpoint (a or b) to be root 
el se 

set the negative endpoint (a or b) to be root 
end while 
return root 


The root found by this algorithm may not be exact, but it will be within epsilon of the root. By making 
epsilon arbitrarily small, you can get arbitrarily close to the exact root. Note that each iteration of the 
loop will cut the size of the interval containing the root in half, maintaining the requirement that the 
polynomial at the endpoints results in values having different signs. 



Applet Exercise 


Write an applet version of the number guessing game described in Section 5.7, Searching an Ordered Array, 
on page 133. The applet should contain at least three buttons and a text field. The text field should be used 
to display the computer’s current guess. The buttons should be labeled, “too small,” “too big,” and “correct.” 
Each time the user chcks one of the buttons, the text field should be updated to display either the new guess 
or a message when the correct answer is guessed. 


A button is implemented with the class J Button. A JButton is like a 3 Label, except that you can respond to 
button clicks using an actionPerformedO method. The following applet creates two buttons and a text 
field. When you chck one of the buttons, the label on the button is displayed in the text field. 

/* <applet code="ButtonApplet.class" width-420 height=100x/applet> */ 

//ButtonApplet.java - using buttons 
import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 

public class ButtonApplet extends lApplet implements ActionListener 

{ 

JButton buttonOne = new JButton("Button One”); 

JButton buttonTwo - new JButton("Button Two"); 

JTextField output * new JTextField(20); 
public void initQ { 

Container pane = getContentPaneO; 
pane.setLayout(new FlowLayoutQ) ; 
pane.add(buttonOne); 
pane.add(buttonTwo); 
pane.add(output); 

buttonOne.addActionListener(this); 
buttonTwo.addActionListener(this); 


} 
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public void actionPerformed(ActionEvent e) { 
String cmd = e.getActionCommandQ ; 
output.setText(cmd); 

} 

} 




Dissection of the Class ButtonApplet 


/* <applet code=”ButtonApplet.class” width=420 height=100x/applet> V 

//ButtonApplet.java - using buttons 

import java.awt.*; 

import java.awt.event.*; 

import javax.swing.*; 

public class ButtonApplet extends JApplet implements ActionListener 

{ 

JButton buttonOne = new JButton("Button One”); 

JButton buttonTwo = new 3Button( M Button Two”); 

JTextField output = new 3TextField(20); 

This example follows the same template used in earlier applet excercises. This time we create two but¬ 
tons and a text field. We give the buttons labels when we create them. 

• public void init() { 

Container pane = getContentPaneC); 

pane.setLayout(new FlowLayout()); 
pane.add(buttonOne); 
pane.add(buttonTwo); 
pane.add(output); 

buttonOne.addActionListener(thi s); 
buttonTwo.addActionListener(this); 

} 

Here we add the two buttons and the text field to the applet. The last two statements state that the 
acti onPerformed () method in this applet should be called whenever either of the buttons is clicked. 

# public void actionPerformed(ActionEvent e) { 

String cmd = e.getActionCommandO; 
output.setText(cmd); 

} 

This method will be called when either button is clicked. To determine which button was clicked, we call 
the method get Acti onCommandQ for the Acti onEvent parameter. This call will return the string used 
to label the button. We then display this string in the text field. 



See Exercise 20 on page 190, for an additional suggestion about implementing this game. 
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A key element in object-oriented programming (OOP) is the ability to derive new classes from existing classes 
by adding new methods or redefining existing methods. The new class can inherit much of its implementa¬ 
tion from the existing class. This process of deriving new classes from existing classes is called inheritance. 
This mechanism of one class inheriting some functionality from another class results in an inheritance hier¬ 
archy, just like the hierarchy that results if you look at the offspring of a person or other organism. The fol¬ 
lowing diagram shows a hierarchy for two generations from a parent. 

The usefulness of inheritance is apparent when we examine how taxonomic classification compactly summa¬ 
rizes large bodies of knowledge. For example, knowing the concept “mammal” and knowing that an elephant 
and mouse are both mammals allows our descriptions of them to be considerably more succinct than they 
would be otherwise. The root concept contains the information that mammals are warm-blooded, higher ver¬ 
tebrates and that they nourish their young using mammary glands. This information is inherited by the con¬ 
cept of both “mouse” and “elephant,” but it is expressed only once: in the root concept. In Java terms, both 
elephant and mouse are derived from the superclass mammal. 

Many useful types are variants of one another, and producing the same code for each is frequently tedious 
and error prone. A derived class, called a subclass, inherits all methods and fields from the parent, or super¬ 
class. The subclass can then be used to add fields or methods. Existing methods can also be redefined, which 
is called overriding. 


7.1 A STUDENT “IS A” PERSON 

Suppose that you needed to develop a system for tracking people at a university or college. You might want 
to maintain information about students, faculty, and staff. The records for these subgroups would have 
inan\ tilings in common, but they would also each have specialized fields that apply only to each subgroup. 
We can represent this with the following diagram. This diagram uses UML notation. UML stands for Unified 
Modeling Language. It is the most widely adopted notation for representing object-oriented program designs. 
The name of the class is at the top of the box. Below that are the names of methods with the “+” indicating a 
public method and the return type of the method shown after the colon. The open unfilled in arrowhead indi¬ 
cates an inheritance relationship between the two classes (e.g. Student extends Person). 
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Inheritance 



Let’s begin with a base class that contains the common information. 


//Person.java - characteristics common to all people 
class Person { 

Person(String name) { 

void setAge(int age) { 

void setGender(Gender gender) { 

void setName(String name) { 

int getAgeQ { 

Gender getGenderO { 

String getNameQ { 


this.name = name; } 
this.age = age; } 
this.gender = gender; 
this,name = name; } 
return age; } 
return gender; 
return name; } 


} 


} 


} 


public String toStringQ { 

return (“Name: “ + name + Age: “ + age + Gender: “ + gender); 

} 

static enum Gender {M, F} 
private String name; 
private int age; 
private Gender gender; 


The class Person has constructors, methods and data members. The implementation details are hidden by 
declaring the fields to be private. All access is done through methods such as setAge(). This approach is in 
accordance with OOP methodology 7 , which stresses the separation of implementation from abstraction or 
concept. We can now create new classes for students, faculty, and staff by extending Person. Here we work 
with only the derived class Student. We choose not to include a default constructor, thus forcing a name 
field to be specified for all Person objects. Including a constructor that allows all fields to be initialized is 
desirable; we leave that for you to do in Exercise 1 on page 225. 


A class can be derived from an existing class by using the form 
class cl ass-name extends superclass-name { 

H • * 

} 


The new class is a subclass of the class from which it is derived, its superclass. The keyword extends defines 
this relationship. The subclass being defined automatically inherits all the data members and methods of its 
superclass. The keyword super is used to rei er to the superclass object that is implicitly part of the subclass 
object. 














































7.1 A Student % a” Person 7 95 


//Student.java - an example subclass 
class Student extends Person { 

Student(String name) { super(name); } 

void setCollege(String college) { this.college = college; 
void setGpa(double gpa) { 

void setYear(YearlnSchool year) { 

String getCollegeQ { 

double getGpa() { 

YearlnSchool getYearQ { 


this.gpa = gpa; } 
this.year = year; 
return college; } 
return gpa; } 
return year; } 


} 


} 


public String toStringO { 

return(super. toStringO + "\n " + 

"College: " + college + 

", GPA: " + gpa + 

", Year: " + year); 


static enum YearlnSchool { frosh, sophmore, junior, senior} 
private String college - "Unknown"; 
private YearlnSchool year; // frosh, sophomore, ... 
private double gpa; //0.0 to 4.0 


The subclass Student has three new fields: col 1 ege, year, and gpa. New methods are used to set and access 
those fields, for example getYearO and setYear (). The subclass Student also overrides the definition of 
the method toStri ng(). 




Dissection of the Class Student 


# class Student extends Person 

We use the keyword extends to declare that a new class will extend an existing class. 

# Student(String name) { super(name); } 

All normal methods are inherited, but constructors are never inherited. A constructor can invoke the 
constructor of the superclass, by making what appears to be a method call but with the keyword super 
as the name of the method. The call to super () must be the first statement in the constructor. If there is 
no call to superC), then the default constructor for the superclass is called automatically before execut¬ 
ing the body of the constructor of the derived class. Although not shown in this example, the call to 
super () can be followed by any other legal Java statements, as with any other constructor. 

# void setCollege(String college)! this.college - college; } 

void setGpa(double gpa) { this.gpa » gpa; } 

void setYearCYearlnSchool year){this.year = year;} 

String getCollegeQ { return college; } 

double getGpaO { return gpa; } 

YearlnSchool getYearO { return year; } 

We provide accessor and mutator methods for each of the fields added by class Student. In general, pro¬ 
viding methods for accessing fields is preferable to exposing the fields for direct manipulation. 
Although we haven’t done so here, by using methods for all access we can later easily add code to verify 
that only legal values are used for setting the fields. If an illegal value is passed to one of the mutator 
methods, we could generate an exception, as described in Chapter 11, Coping with Errors. 
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Inheritance 



IP public String toStringQ { 

return(super.toStringC) + "\n " + 

"College: " + college + 

", CPA: " + gpa + 

", Year: " 4 * year); 

} 

When a subclass such as Student redefines a method found in the superclass, it is called overriding. 
That is what we do with the method to St ri ng () . We can still access the overridden version in the super¬ 
class by using the keyword super, as shown in this example. Here we use the superclass version of 
toStri ng() to get the string representation of the fields inherited from the class Person, and then we 
append the string representation of the new fields. 

HP static enum YearlnSchool { frosh, sophmore, junior, senior} 

We provide constants so that code that sets the field Year will be self-documenting, as shown in the next 
example. This is an example of a nested or inner class ( see Section 6.15, Nested Classes, on page 179). 
Because of the nested definition, these enum contants will be referred to as Student .Yearln¬ 
School .frosh, etc. 



Keep in mind that every Student object is also a Person object. This “is a” relation will always hold between 
a derived class and its superclass. All method calls that could be made for a Person object can be made with 
a Student object, as shown in the following program. 

//StudentTest.java 
class StudentTest { 

public static void main(String[] args) { 

Student student = new Student("Dane Programmer"); 

student.setAge(21); 

student.setGender(Person.Gender.F); 

student.setCol1ege("UCSC"); 

student.setYear(Student.YearlnSchool.frosh); 

student.setGpa(3.75f); 

System.out.println(student.toString()); 

} 

} 

The output of this program is 


Name: Dane Programmer, Age: 21, Gender: F 
College: UCSC, GPA: 3.75, Year: frosh 


Note that, although the class Student doesn’t explicitly declare the methods setAgeQ or setGender(), 
those methods can be called. They are automatically inherited from the class Person. 

Benefits of using a subclass 

# Code is reused. The Student type uses existing, tested code from Person. 

# The hierarchy reflects a relationship found in the problem domain. When we speak of a “per¬ 
son,” the special grouping “student” reflects the real world and its treatment of this group. 

# Various mechanisms will allow other code to treat Student as a subtype of Person, simplifying 
the code while granting it the benefits of maintaining these distinctions among subtypes. 
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Common Programming Error 

Forgetting to use super when overriding methods can lead to incorrect code. For example, if we mistak¬ 
enly code the Student. toSt ring () method as 

public String toStringQ { 
return(toString() + "\n " + 

"College: " + college + ", CPA: " + gpa); 

rnal call of toSt ri ng() would be a recursive call, leading to a nonterminating method execu¬ 
tion. Why wouldn’t the compiler know that we want to reference the super method Per¬ 
son . toStri ng()? The reason is that, when a name isn’t qualified by an object reference, a class name, 
super, or this, the compiler always looks for a definition in the current class before looking for an 
inherited method. When using inheritance, you have to be careful to select the right name if you’ve 
defined an identifier in both the superclass and subclass. 
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7.2 OVERRIDING INSTANCE METHODS 


As shown in the preceding example with the method toStri ng(), Java supports overriding methods , which 
are declared in one class and redefined in a subclass. The class hierarchy that results from the use of inherit¬ 
ance creates a related set of user types. Instances of any subclass of a given superclass may be referenced by 
a superclass variable. For example, an object of type Student may be referenced by a variable of type Per¬ 
son. The reverse isn’t true. Because such referencing is valid in Java, the following subtype principle holds for 
all subclasses. 

A subclass object can always be used where an object of its superclass is expected. 

l his principle holds because all the methods needed for the superclass are available for the subclass object. 
Look at the example of Person and Student. The methods you might call if you thought you had a Person 
object include setNameO, setAgeQ, setGenderQ, and toStri ng(). These methods are all defined by vir¬ 
tue of inheritance for any Student object, in addition to those added to Student. 

When calling a method that has been overridden, the Java run-time system selects the method definition that 
corresponds to the actual type of an object, regardless of the type of variable used to reference the object. 
The object being referred to carries around type information so that this distinction can be made dynami¬ 
cally, a feature typical of OOP languages. Each object “knows” how it is to be acted on. This capability is vari¬ 
ously called dynamic typing, dynamic method dispatch, or pure polymorphism. Both the noun polymorphism 
and the adjective polymorphic come from poly-, meaning “many,” and - morphic , meaning “having such a 
form ; in this case a polymorphic variable or object can take many forms. 

Suppose that we added the following two lines to the end of the example declaring a Student object for 
“Jane Programmer” at the end of Section 7.1, A Student 7s a”Person, on page 194. 

Person anyPerson = student; 

System.out. pri ntl n (anyPe rson,toString()); 

Here we’ve assigned the variable anyPerson, which is declared to be a reference to a Person object, to point 

to the same object referred to by the variable student. The object is in fact a Student object. But as just 

described, this duplication is fine. Any student is also a person, both in real life and as modeled by Java in 

this ex amp le. We can t call the methods in class Student by using the reference anyPerson in the following 
manner. 

anyPerson.setYear(Student.YearlnSchool.frosh); // illegal 
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A compiler can’t, in general, figure out that this particular Person object is in fact also a Student. However, 
at run time the Java virtual machine can figure it out, so when you make a call to an overridden method such 
as toStri ng() that is defined in both classes, the one for the actual type of the object is called. Therefore 
the call to any Per son. toStri ng() above will return the result of calling toStri ng() as defined in class 
Student, not the one in class Person. The output of the statement will be the same as for the earlier print. 


Name: Jane Programmer, Age: 21, Gender: F 
College: UCSC, GPA: 3.75, Year: 1 


Distinguishing overriding from overloading is important. Recall our discussion of overloading in Section 
4.12, Method Overloading , on page 109. We showed that in overloading several methods can differ only in 
their signatures, that is, in the number and type of formal parameters. We also demonstrated that the com¬ 
piler can resolve overloading and select the appropriate method at compile time. 

In contrast, overriding involves two methods with the same signatures except for differences in the implicit 
first parameter, that is, the one before the dot in expressions such as x.methodName(. . .). In overriding, or 
pure polymorphism, determination of the actual method to call must be postponed until execution time. 
Then the actual type of the implicit parameter can be determined from the type information associated with 
all objects. 


7.2.1 CALLING printQ AND print!n() WITH ANY OBJECT 

The dynamic determination of methods resulting from overriding is what makes possible the calling of meth¬ 
ods pri nt () and pri ntl n () with any legal Java value. These methods are overloaded to accept one parame¬ 
ter that matches any of the primitive types or a parameter of type Object. All Java classes are implicitly 
derived from the class Object, except Object itself which has no superclass. The class Object includes a 
method toString(). When pri nt() is called with a primitive type, overloading allows the compiler to insert 
machine code to call the proper method. When pri nt () is called with any reference type, the implementa¬ 
tion of pri nt() first calls the toStri ng() method for the object. Just as our call to toStri ng() called the 
method in Student instead of the method in Person, the call inside pri nt() calls the toStri ng() method 
for the actual class of which the object is an instance. Thus our statements involving pri ntl n() for anyPer- 
son could just as well—and in fact more properly—be written like 

System.out.println(anyPerson); 

There is nothing special about toStri ng(), other than the fact that it is defined in the class Object. This 
dynamic type resolution works for any method that is overridden in a subclass. The following contrived 
example shows this same dynamic selection of methods. 

//Superclass.java - a sample super class 
class Superclass { 
public void printQ { 

System.out.println(" inside Superclass"); 

} 

} 

//SubClass.java - a subclass of Superclass 
class Subclass extends Superclass { 
public void printQ { 

System.out.println(" inside Subclass"); 

} 


} 
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//Testlnherit.java - overridden method selection, 
class Testlnherit { 

public static void main(String[] args) { 

Superclass someSuper = new SuperClass(); 

Subclass someSub = new SubClassQ; 
printAny(someSuper); 
printAny(someSub); 

} 

void printAny(SuperClass s) { 
s.print() ; 

} 

} 

The output of this program is 


inside Superclass 
inside Subclass 


The first time pri ntAny () is called, s is referring to a Superclass object; therefore s.print() calls the 
print() in Superclass. The second time pri ntAny () is called, s is referring to a Subclass object; there¬ 
fore the printQ hi Subclass is called. 
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73 THE ACCESS MODIFIERS private AND pub! ic REVISITED 


Java has four different protection modes for fields and methods. The one that we have used the most is the 
default protection mode, called package access, that is in effect when no protection modifier is specified. 
Package access allows a field or met hod to be accessed by code in any method in any class within the samp 
package. We discuss packages in Section 12.11, Packages, on page 380. 

The access mode private, signified by the keyword pri vate, means that the method or the field can be refer¬ 
enced only from methods in the same class as the definition of the private field or method. This protection 
mode is preferred for most fields. When necessary', access should be provided to private fields through meth¬ 
ods. In this way the implementation details of the class can be modified without affecting code that uses the 
class. Recall that this approach is known as data hiding 

The designation pub! i c is used to export fields and methods so that they can be accessed outside the pack¬ 
age in winch they are defined. As we haven’t been building packages, we’ve generally not used the keyword 
publ i c. In two specific cases we were forced to use the keyword pub! i c. In the first case, we had to make 
Ene method mai n() pubhc so that the part of the Java virtual machine that starts a program could access the 

method. That is, we needed to export the method mai n () outside the default unnamed package in which it is 
defined. 

In the second case, we needed to use public for the method toStringO. As previously discussed, the 
method toStri ng() is defined for the class Object, which is a superclass of all classes. In Java, we aren’t 
allowed to use overriding to decrease the accessibility of an inherited method. Because toStri ng() is inher¬ 
ited by every class and has the most accessible designation—namely, publ i c —no overri din g definition can 
specify any tiling other than pubhc access. Without this restriction, the important principle that a subclass 
object can always be used where a superclass object is expected would be violated. For example, if our class 
Student overrode the method toStringO to be private, then the statement 

System.out.println(anyPerson.toString()) ; 

w ith anyPerson pointing at the Student object for Jane Progr amm er, would compile but fail at run time. The 
dynamic typing system would determine that anyPerson was referring to an object of type Student and 
attempt to call toStri ng (), but toStringO is private, making access illegal. 
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Classes can have only two designations: pub! i c or package access, which is signaled by no modifier. 


Common Programming Error 

Narrowing access isn’t legal when you’re declaring an overridden method. An example is as follows. 

class Point { 
int x, y; 

public String toStringQ { 

return String.valueOf(x) + " , ,r + String.valueOf(y) ; 

} 

} 

class ColorPoint extends Point { 

int color; // 0 = white, 1 = red, 2 = blue 
String toStringO { 

return super.toString() + " color is " + color; 

} 

} 

The compiler reports that you attempted to narrow the access of the overridden Color- 
Poi nt . toStri ng(). This method needs to be labeled publ ic, as it was in the class Poi nt. 
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7*4 PACK Ay ty 


Even the simplest Java program uses classes that were written by others. This ability to reuse parts of pro¬ 
grams is essential for building complex software systems. Collections of functions, procedures, or classes are 
often called libraries. Essentially all programming languages or their development systems provide some 
mechanism for a program to use these routines or classes. 

* 

In Java, groups of related classes can be placed in a package. There are two primary 7 reasons for organizing 
classes into packages. First, a field or method that is defined without any of the access modifiers—publ i c, 
protected, or private—can be accessed only from a method in a class from the same package. This is 
called package access. Thus classes can expose some implementation details to other classes in the same 
package but not to classes outside the package. 

The second reason for using packages is to provide separate name spaces. This provision allows two differ¬ 
ent progr amm ers or organizations to have classes with the same name and still use these classes in one pro¬ 
gram. For example, a software company that would like to define some of the standard mathematics 
functions slightly differently could create its own class Math. It should be placed in a package with a name 
derived from the company’s name because part of the Java specification is a naming scheme for packages. 
This scheme is somewhat like Internet addresses in reverse, with the most general part of the name first. So a 
company with the Internet address www.coolsoft.com might name its package containing the class Math 
com. cool soft. general . If the CoolSoft Corporation had a collection of classes that it used for handling 
standard container data structures, it mi g ht put them in a different package called com. cool soft. contai n- 
ers. This package might have classes with some of the same names as those in the standard Java package 
java, uti 1 . For example, finding a better name than Stack for a class that implements a stack is difficult. 
There is already a class named Stack in j ava .util. Without packages to provide different name spaces, you 
couldn’t write a program using com. cool soft. contai ners . Stack in one place and java, uti 1. Stack 
somewhere else. 
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Let’s review how to use packages. Whenever you want to use a class from an existing package, you need to 
use an import statement to import the class. For simplicity, you can import all the classes from a package 
with import statements such as 


import java.util.*; 

This statement imports aU the classes in the package java. util. The is called a wildcard, meaning “give 
me all the classes.” You can also import specific classes. For example, we can use 

import java.uti1.Scanner; 


Another alternative is not to use an i mport statement but instead always spell out the full name of the class. 
It is called the qualified name and includes the package name. This option can be rather awkward and isn’t 
recommended if you intend to use the name of the package more than once. For example, you could use the 
following to create a Scanner for reading from the console. 


java.uti 1 .Scanner in = new java. uti1. Scanner(System.in); 

The i mport statement told the compiler that if it encountered a class name it didn’t recognize, it should try 
looking for it in the imported package. Import statements can save a lot of typing. 

This explicit naming mechanism makes the use of two different Math classes possible. Here is how you could 
use the class Math from CoolSoft. 


double x = Math.sqrt(y); // from java.lang 
double y = com.cool soft.Math.sqrt(y); 

You don’t have to import the package j ava. 1 ang. It is imported by default into every 7 Java class. That’s why 
we could write Math. sq rt (), which uses the class Math from package j ava. 1 ang, without having to use an 
i mport statement. The package java. 1 ang is the only package that is automatically imported. 


7.4,2 CREATING PACKAGES 

Every Java program can use classes from one unnamed package. Any classes in a single directory on your 
computer’s disk that don’t specify a package name are part of the same unnamed package. To place the 
classes in a named package, you need to do two things: add a package statement to the top of each class in 
the package, and place the classes in an appropriately named location on your computer’s disk. 

As a simple example we will put our Person and Student classes into a package called jbd. database. The 
first few lines of those two classes now become: 

//Person.java - characteristics common to all people 
package jbd.database; 

class Person { 

Person(String name) { this.name = name; } 

■ m h 

//Student.java - an example subclass 
package jbd.database; 

class Student extends Person { 

Student(String name) { super(name); } 


We need to place the source files in a subdirectory where the path to the subdirectory from the current direc¬ 
tory is the same as the package name replacing any dots in the package name with the pathname separator 
for the local file system. For example, on Unix our package jbd. database would be in the subdirectory jbd/ 
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database and on a Windows system it would be in jbd\database. If you’re using a Unix or Windows command 
line to compile your Java programs, then with your current directory set to the one containing the subdirec¬ 
tory jbd, execute the command 

javac jbd/database/*.java 

Note that the current directory is not jbd but the one containing the subdirectory jbd. This command com¬ 
piles all the Java source files in the subdirectory. The co mm and shown is for Unix. On Windows you would 
use a “V instead of a “/” to separate the elements in the pathname. If you’re using an integrated develop¬ 
ment environment, you’ll probably have to create a project that includes the files from the package and then 
compile them. A project is the term used by most integrated development environments for a group of 
related files. 

By default, Java looks for packages in the directory where Java was installed and then looks for packages in 
the current working directory. You can change this procedure by changing the CLASSPATH environment vari¬ 
able. Check with your instructor or read the documentation for your system to determine the appropriate 
way to make this change. For small projects this change usually isn’t necessary. 


7.43 THE ACCESS MODIFIER PROTECTED 

When you’re not extending existing classes from other packages, the three access levels, package, private, 
and pubhc, are all that apply. You can use a fourth access level when desig nin g a class for export from a 
package. All classes with no package declaration are part of a single, unnamed package. If you expect classes 
in other packages to extend a class that is part of a named package, the use of the access modifier pro¬ 
tected may be helpful; it can be applied to both methods and fields. 

Access to a protected member from within the same package is the same as package access. That is, adding 
protected to a field or method has no affect on the accessibility of the field or method from classes in the 
same package. 

Access to a protected member from classes defined outside the package contai n i n g the class with the pro¬ 
tected member is permitted only if the accessing class is a subclass of the class with the protected member. 
That is, from outside the package, a protected member is like a private member unless the method doing the 
accessing is part of a class derived from the class with the protected member. This description is a slight 
simplification; for elaboration see the Common Progr ammin g Error at the end of this section on page 244. 

Let’s consider our example class Person further. Suppose that we were designing a package that would 
include Person and possibly some classes derived from Person, such as Student. If we believed that others 
might want to derive their own subclasses of Person, we might decide to give protected access to the fields, 
declaring them as 

package jbd.database; 
public class Person { 

* w m 

protected String name; 
protected int age; 
protected Gender gender; 

} 

Note that we also added the keyword publ i c to the class definition. This addition is necessary if we want to 
export the class from the package cont ainin g it. We also add publ i c to the method definitions. Changing the 
fields from private to protected has two effects. First, it makes them accessible anywhere in the package, 
which weakens data hiding. We can no longer freely change the names of these fields or their implementa¬ 
tions. We must now consider the impact of such a change on the rest of the package. Second, the switch to 
protected access makes these fields accessible outside the package, but only in classes that extend Person. 
For example, we could have 
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import jbd.database.*; 
class Driver extends Person { 


public boolean needsDriverEd() 
if (age < 25) 
return true; 
el se 

return false; 

} 


{ 


} 

The class Driver is assumed to be defined outside the package jbd.database. Because the field age has 
protected access, it can be directly accessed in the subclass Dri ver.As a general rule, you should avoid pro¬ 
tected access because it seriously erodes data hiding. Once you have exported a protected field, you can’t 
change the field without considering any class that imports the package containing the class with the pro¬ 
tected member. 

Let’s review the access levels. 

Access Levels 

1. Private—Use this level whenever possible. You can make changes to private members by examin¬ 
ing only the class containing the member. This restriction provides maximum information hid¬ 
ing. 

2. Package—Lise this level when one class needs to be aware of some implementation details of 
another class in the same package. You may use package access for fields that are used heavily 
by other classes in the same package. You may use this option instead of access methods such 
as setY() and getXQ, which should almost always be used to provide access to fields from out¬ 
side a package. 

3. Protected—Use this level when designing a class to be reused via inheritance from outside the 
package in which it is defined. You should carefully consider any decision to export a protected 
member. Such exporting seriously weakens information hiding and makes program maintenance 
significantly more difficult and error prone. 

4. Public-Reserve use of this level for the required interface elements to a class or package. You 
should never expose unnecessary 7 implementation details with public access. Exporting a field 
with public access is very unusual, unless the field is also declared to be f i nal. 
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Common Programming Error 

Our description of protected access was slightly oversimplified. Let’s consider the following program 
fragment. 

//SomeSuper.java 

// assume this is part of the package PKG1 
public class SomeSuper { 
protected int prot; 

m m m 

} 

//SomeSub.java - not in package PKG1 
import PKG1.*; 

class SomeSub extends SomeSuperf 
void ok(...) { 

prot = 0; // this would be ok 

} 

void alsoOk(SomeSub subReference) { 

subReference.prot = 0; // this is also ok 

} 

void notOk(SomeSuper superReference) { 
superReference.prot = 0; 

} 

} 

The assignment to prot in method ok() is fine. This assignment is to the prot field inherited by the 
object on which the method ok() is operating. The assignment to prot in method al soOk() also is 
okay. In this case the assignment is made to a protected field by a reference of type SomeSub. The assign¬ 
ment to prot In method notOk() shows how our earlier description of protected was oversimplified. In 
this last case we ate attempting to make an assignment to a protected field by using a reference of type 
SomeSuper. In fact, a subclass may access a protected member of a superclass only when that access is 
made with a reference to a subclass object. In method ok() we are implicitly using the SomeSub refer¬ 
ence thi s. In method al soOk() we are explicitly using the SomeSub reference subReference. In method 
notOk() we are trying to reference the protected field by using a SomeSuper reference, not a SomeSub 
reference. 



7.5 TYPE Object AND INHERITANCE 


As we discussed earlier, in Java everything inherits from class Object. Thus Object is generic, in that any 
operation applicable to an instance of the class Object is applicable to an instance of any class. This charac¬ 
teristic enables us—through inheritance—to write generic methods. A generic method is a method that has at 
least one parameter that can be an instance of several different types. We presented an example of this capa¬ 
bility in how the pri ntl n 0 method uses toStri ng () to attempt to print any object’s string representation. 
Java style is to have a toStri ng () method as an overridden method in a class for output and debugging pur¬ 
poses. 

Another Object method is equal s(). This method is supposed to return true if elements have the same 
value. The default method defined in class Object takes the strictest interpretation of equals. It returns true 
if and only if the two references refer to the same object. This definition of equals is also the only one that 
could be implemented in the class Object. Other classes that are designed to be used in comparisons using 
equals can override the method equal s() to be less strict. For example, two Counter objects could be con- 
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sidered equal if they contained the same value field, which isn’t the same as having two references to the 
same Counter object. 

We can use the method equal s () to create a method to count the number of items in an array that have a 
particular value. The following method is called a generic method because it works for any array of nonprim- 
itive values. 

//Count the number of times obj is found in array, 
static int howManyCopiesOf(Object obj, Object[] array) { 
int count = 0; 

for (int i =0; i < array.length; i++) 
if (obj.equals(array[i])) 
count++; 
return count; 

} 

Because of the subtype principle, this method can be passed an array of any type of nonprimitive objects. 
There will always be some method equal s(), but, as previously discussed, the one defined in class Object 
may not always give the desired result. The following contrived program shows howManyCopi esOf () being 
called with two different types of arrays. 

//EqualsTest,java - 
class EqualsTest { 

public static void main(String[] args) { 

// Create and fill an array of Strings 
String[] stringArray = new St ring[10]; 
for (int i =0; i < stringArray.length; i++) 
stringArray[i] = "String " + i; 

// Create and fill an array of Counters 
Counter[] counterArray = new Counter[5]; 
for (int i = 0; i < counterArray.length; i++) 
counterArray[i] = new Counter(); 

// Make two entries refer to the same Counter 
counterArray[2] = counterArray[0]; 

System.out.println(howManyCopiesOf(counterArray[0], counterArray)); 

System.out.println(howManyCopiesOf("String 1", stringArray)); 

} 

//Count the number of times obj is found in array, 
static int howManyCopiesOf(Object obj, Object[] array) { 
int count = 0; 

for (int i =0; i < array.length; i++) 
if (obj.equals(array[i])) 
count++; 
return count; 

} 

} 

When we use the class Counter from Section 6.9, Static Fields and Methods , on page 3 69, the preceding code 
will print 2 and then 1. Although the Counter objects are all set to 0, we haven't defined an equal s() 
method for the class, so the default equal s() method in Object is used. That method simply checks to see 
whether the references are to the exact same physical object. For the class Stri ng there is an equal s () 
method; therefore one entry in the stri ngArray array contains a Stri ng equal to "Stri ng 1" as deter¬ 
mined by the method equal s (). How will the output change if we add an equal s () method to the class 
Counter? See Exercise 16 on page 226. 
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7.6 ABSTRACT CLASSES 


A root of a class hierarchy often contains methods that all subclasses must override. There may be no mean¬ 
ingful way to implement such a method in the root class. In that case the root class is declared to be abstract, 
and any methods that must be overridden in the subclasses are also declared to be abstract. 

An abstract method is used to defer the implementation decision of the computation to a subclass. In OOP 
terminology it is called a deferred method. A class that contains abstract methods is an abstract class, which 
has the form 


abstract class class-name { 

abstract type method-id(argument-list') ; 

...//other concrete and abstract methods 

} 

It is often useful for the root class in a type hierarchy to be an abstract class. By root here we mean a local 
root because in Java there is only one type hierarchy and it has Object as the root. When implemented as an 
abstract class, a local root defines the basic common properties of its derived classes but can’t itself be used 
to create objects. Reference variables can be declared with an abstract type. Such a reference will always 
point to an actual object that is a subtype of the abstract type. 


For example, we could create a collection of different types of counter classes, all with some co: 
hires. Here is an abstract counter class. 


inn 
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abstract public class AbstractCounter { 
abstract public void click(); 
public int get() { return value; } 
public void set(int x) { value = x; } 

public String toStringO { return String.valueOf(value) ; } 
protected int value; 

} 

Using this abstract class as a superclass, we can derive our earlier Counter class as follows. 

public class Counter extends AbstractCounter { 

public void click() { value = (value + 1) % 100; } 

} 

We could also create a counter that counts by 2, using 

public class CountByTwo extends AbstractCounter { 
public void click() { value = (value + 2) % 100; } 

} 

We might then have a program that needed a counter. Under user control, the program might sometimes 
operate with a count-by-2 counter and sometimes with a count-by-1 counter. In that case we could write the 
program to just assume some type of counter. The following code fragment shows a method that expects a 
parameter that is any subclass of AbstractCounter. 

void sampleMethod(AbstractCounter counter) { 

4 * ■ 

counter.click(); 

mum 

} 

Although we can’t create an AbstractCounter object by using new, we can declare parameters and variables 
of type AbstractCounter. Recall that the subtype principle says that a subtype can be used anywhere the 
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supertype is expected. Here we expect an AbstractCounter, so any subtype of AbstractCounter is allowed 
to be used. Thus, we can call sampl eMethodO, passing it a reference to either a Counter object or a Count- 
ByTwo object. 

These two subclassses of AbstractCounter added the minimum amount of implementation possible. We 
can also override the methods provided by the abstract base class. The following class extends Abstract- 
Counter, overriding the method set C), in addition to providing an implementation for cl i ck(). 

class Timer extends AbstractCounter { 
public Timer(int v) { set(v); } 
public void click() { 
value++; 

seconds = value % 60; 
minutes = value / 60; 

} 

public void set(int v) { 
value = v; 
seconds = v % 60; 
minutes = v / 60; 

} 

public String toStringO { 

return minutes + " minutes, " + seconds + " seconds"; 

} 

private int seconds, minutes; 

} 

This class treats each click as a second of time. It maintains the total number of seconds in val ue, as well as 
the amount in the usual format of minutes and seconds. The class overrides set () and toStri ng() and 
defines the required method cl i ck(). 

Note that the preceding implementation of the class Timer may not be the best if Timer is chcked much 
more frequently than it is displayed. Each click requires a division and a modulus operation. The following is 
an alternative implementation that has the same visible behavior, although the internal implementation 
details are different. 

class Timer extends AbstractCounter { 
public Timer(int v) { set(v); } 
public void clickQ { value++; } 
public String toStringO { 

return (value / 60) + " minutes, " + (value % 60) + " seconds"; 

} 

} 

The choice of which is the proper implementation depends on how you’re going to use the class. The nice 
thing about the data abstraction provided by Java and other OOP languages is that at any time you can sub¬ 
stitute an alternative Implementation without making any changes to the rest of the program. 



7.7 AN EXAMPLE: PREDATOR-PREY SIMULATION 


Object-oriented programming was originally developed as a simulation methodology , using the program¬ 
ming language Simula 67. Hence many of the ideas underlying OOP are best understood in terms of modeling 
a particular reality. In this section we use a set of classes and inheritance to simulate an artificial ecology. 

The world in our example has different forms of life that interact. We derive classes for modeling the life 
forms from a single abstract class, Li vi ng. Our simulation includes foxes as an archetypal predator, with 
rabbits as prey; the rabbits eat grass. The resulting class hierarchy is shown in the following UML diagram. In 
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addition to showing the inheritance relationships, this diagram shows some of the key methods supported 
by each of the classes. 
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Our simulated world consists of a two-dimensional array of life forms. In this simple version, we use a single 
character to display each life form: ' F' for fox, 1 R' for rabbit, ' G' for grass, and f . ' for an empty cell in the 
two-dimensional world. 

During each cycle of the simulation, certain rules are apphed to determine which life form will occupy a cell 
in the next cycle. The rules are based on the populations in the neighborhood of a given cell. This approach is 
similar to Conway's Game of Life simulation. 

In addition to the classes representing the life forms, we use the class Worl d to represent the world in gen¬ 
eral. As already indicated, the world consists primarily of a two-dimensional array of life forms. In addition, 
the Worl d class provides operations for initially filling a world with life forms and for advancing from one 
step to the next in the simulation. The simulation actually consists of two Worl d objects: One represents the 
current state of the world, and the other is used to store the state of the world in the next cycle. The follow¬ 
ing pseudocode is for the top level of the simulation. 

Pseudocode for Predator-Prey simulation 

create two worlds, current and next 
initialize one with some life forms 
print the initial world 
for each step of the simulation 
update next based on current 
print the next world 
switch the roles of current and next 
end of for loop 

A key element of the rules used to compute which life form will occupy a cell in the next cycle is the number 
of various life forms in adjacent or neighbor cells. To handle this, each class that implements a life form 
must contain a static count to store the count of that particular life form. Using these counts in the various 
life form classes, we can use the following pseudocode to describe how we compute the count of neighbors 
for a single cell. 

Pseudocode for counting neighbors 

set the count for all life form types to 0 
for each of the current cells 8 immediate neighbors 
if the neighbor is type LifeType 
then increment the count for LifeType 
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Because the counting neighbors code is the same for all life forms, we implement this operation as compute- 
Nei ghbors () in the abstract class Li vi ng. In this way, all life form classes will inherit this operation. 

We are now ready to look at the actual implementation of the classes. We begin at the top, with the class 
PredatorPrey, which is simply a place to put the method mai n() for the program. 

//PredatorPrey.java - top level class 
class PredatorPrey { 

public static void main(String[] args) { 

World odd = new World(10), even = new World(10); 
int i, cycles = 10; 

even.edenO; //generate initial World 

System.out.println(even); //print initial state 
for (i =0; i < cycles; i++) { 

System.out.println("Cycle = " + i + "\n\n"); 
if (i % 2 == 1) { 
even.update(odd); 

System.out.println(even); 

} 

else { 

odd.update(even); 

System.out.println(odd); 

} 

} 

} 

} 

Any of several approaches may be used to cycle between the two Worl d objects. In the preceding implemen¬ 
tation we elected to name one of the worlds even and the other odd. Thus when the cycle number is even, 
even is the current world and odd is the next world. In the next cycle—when the cycle number is odd—the 
roles are reversed. The code indicates that the class Worl d must contain the methods eden (), update(), and 
toStri ng(). We also decided to have the world always be a square array. Therefore the constructor for 
Worl d accepts only a single parameter, which is the number of cells in a row or column. 

//World.java - square grid of life form cells 
class World { 

World(int n) { 

size = n; cells = new Living[n][n]; 
for (int i =0; i < size; i++) 
for (int j = 0; j < size; j++) 
cel 1s[i][j] = new Empty(i,j); 

} 

public void clearNeighborCountsQ { 

Fox.neighborCount.set(0); 

Rabbit.neighborCount.set(0); 

Grass.neighborCount.set(0); 

Empty.neighborCount.set(0); 

} 

void edenQ { // left as an excercise } 

public String toStringO { // left as an excercise } 

public void update(World oldWorld) { 

//borders are taboo 
for (int i = 1; i < size - 1; i++) 
for (int j = 1; j < size - 1; j++) 

cel1s [i][j] = oldWorld.cells[i][j].next(oldWorld); 

} 

Living[] [] cells; 

private int size; //set in constructor 
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The pseudocode for “counting neighbors” includes the line “set the count for all life form types to 0.” Only 
the class Worl d knows about all the possible life forms in a particular simulation. Therefore the class Worl d 
provides the operation clearNeighborCountsC). This method sets the static field, neighborCount, found 
in each life form class, to 0. 

The method updateO visits each cell in the previous world passed as a parameter to updateO, invoking the 
next () operation on the cell. The result of next () is stored as the state of the cell In the new world, which is 
the one upon which updateO was invoked. Note that updateO doesn’t visit any of the cells on the outer 
border. This omission avoids an index out of bounds error when the neighbors are counted. Note that border 
cells are missing some neighbors. As a result, the state of a border cell never changes. This oversight can be 
corrected with a bit more logic in the computeNei ghbors () method of Li vi ng. We leave that for you to do 
as Exercise 14 on page 226. 

As discussed earlier, all life form classes are derived from an abstract class Li vi ng. 

//Living.java - the superclass for all life forms 
abstract class Living { 
abstract Count getCountO; 
abstract Living next(World world); 
abstract char toCharQ; // character for this form 

void computeNeighbors(World world) { 
world.clearNeighborCounts(); 
world, cel Is [row] [column] .getCountO .set(-l) ; 
for (int i = -1; i <= 1; i++) 
for (int j = -1; j <= 1; j++) 

world.cel 1 s[row+i] [column+j].getCountO .inc() ; 

} 

int row, column; //location 

} 

In this simulation, a life form “knows” its location, as represented by the two integer instance variables row 
and col umn. For each new life form, implementations for getCountO, next(), and toChar()must be pro¬ 
vided. We discuss these methods in the dissection of the class Fox. 

The method computeNei ghbors () is used by each of the classes derived from Li vi ng. The code for com¬ 
puteNei ghbors() follows directly from the pseudocode presented earlier. This code uses the method get¬ 
CountO to get a reference to the Count object used in counting neighbors. The class Count is a simple 
wrapper for an integer, with methods to get, set, and increment the count. There is one Count object in each 
class derived from Li vi ng. The double for loop increments the count for the current cell, as well as the 
counts for each of the neighbors. We don’t want to count the current cell as a neighbor, so we set the count 
for the current cells type to -1 initially. We leave implementation of the class Count for you to do in Exercise 
11 on page 225. 

We are now ready to present the implementation of the actual life form classes. In addition to the three life 
forms fox, rabbit, and grass, we need to provide a class that extends Living to represent an empty cell, 
which becomes the class Empty. The rules of the simulation are contained in the nextQ methods of these 
classes. Each implementation of next () begins by computing the counts of neighbors, using the method 
computeNei ghbors () inherited from Li vi ng. Then each life form class can query the various other life form 
classes to determine how many neighbors of a particular type exist. Most life forms care only about some of 
the other life forms. For example, in our rules, the Fox class only cares about how many foxes and how many 
rabbits are nearby. The Fox class doesn’t care about how much grass is nearby. 

//Fox.iava - prey class 
class Fox extends Living { 

Fox(int r, int c, int a ) { 
row = r; 
column = c; 
age - a; 

} 
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Living next(Wor1d world) { 
computeNeighbors(worl d); 

if (Fox.neighborCount.getO > 5 ) //too many Foxes 
return new Empty(row, column); 
else if (age > LIFE_EXPECTANCY) //Fox is too old 
return new Empty(row, column); 
else if (Rabbit.neighborCount.get() ===== 0) 
return new Empty(row, column); // starved 
el se 

return new Fox(row, column, age + 1); 


public String toString(){ return "Fox age " + age; } 
char toCharO { return 'F r ; } 

Count getCountO { return neighborCount; } 
static Count neighborCount = new Count(); 
private int age; 

private final int LIFE_EXPECTANCY = 5; 




Dissection of the Class Fox 


# class Fox extends Living { 

Fox (int r, int c, int a ) { 
row = r; 
column = c; 
age - a; 

} 

Each life form “knows” where it is located. We create a Fox by specifying the coordinates of the cell in 
which it will be placed and giving it an initial age. 

$ Living next(World world) { 
computeNeighbors(world); 

if (Fox.neighborCount.getO > 5 ) //too many Foxes 
return new Empty(row, column); 
else if (age > LIFE„EXPECTANCY) //Fox is too old 
return new Empty(row, column); 
else if (Rabbit.neighborCount.get() == 0) 
return new Empty(row, column); // starved 
el se 

return new Fox(row, column, age + 1); 

} 

The method next () contains the rules for what happens in the next cycle to a cell that currently con¬ 
tains a fox. In our simple rules the fox will die if there are too many foxes nearby, if the fox is too old, or 
if there are no rabbits for the fox to eat. 

# public String toString(){return "Fox age " +age;} 

Although not used in our simulation, we include the standard toSt ri ng () method, which might be used 
in debugging. Unlike the simple one-character representation used in our display, the Stri ng represen¬ 
tation includes the age of the fox. 

% char toCharQ { return T F f ;} 

We use the method toCharQ in the method toStri ng() of World to create a simple representation of 
the world. 
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♦ Count getCountQ { return neighborCount;} 
static Count neighborCount = new CountO; 

For each class that extends Li vi ng, a method getCount () must be implemented. Although the count Is 
stored in a static variable, we use an instance method to access the count. This approach allows us to 
take advantage of dynamic method dispatch so that the code in the method computeNeighborsQ in 
Li vi ng can get the counter for a particular class, using an instance of the class. 

# private int age; 

private final int LIFE_EXPECTANCY = 5; 

These two fields, along with the row and col umn fields inherited from Li vi ng, constitute the state of a 
particular Fox object. In our simulation all foxes die after five cycles, if not sooner. We could easily 
change this parameter to some random value over a range of values. 



The classes Rabbit, Grass, and Empty are essentially the same as Fox, except that the rules in next() are 
different. 


//Rabbit.java - prey class 
class Rabbit extends Living { 

Rabbit(int r, int c, int a ) { row = r; column = c; age = a;} 


Living next(World world) { 
computeNeighbors(world); 
if (Fox.neighborCount.get() >= 

Rabbit.neighborCount.get() ) 
return (new Empty(row, column)); 
else if (age > LIFE__EXPECTANCY) 
return (new Empty(row, column)); 
else if (Grass.neighborCount.get() 
return (new Empty(row, column)); 
el se 

return (new Rabbit(row, column, age + 1)); 

} 


// eat Rabbits 


old 


// too 
— 0 ) 

// starved 


public String toStringQ {return "Rabbit age " + age;} 
char toChar() { return *R'; } 


Count getCountQ { return neighborCount; } 
static Count neighborCount = new CountO; 
private int age; 

private final int LIFE„EXPECTANCY - 3; 


//Grass.java - something for the rabbits to eat 
class Grass extends Living { 

public Grass(int r, int c) { row = r; column = c; } 
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public Living next(World world) { 
computeNeighbors(world); 

if (Grass.neighborCount.get() > 2 * Rabbit.neighborCount.get()) 

// rabbits move in to eat the grass 
return (new Rabbit(row, column, 0)); 
else if (Crass.neighborCount.get() > Rabbit.neighborCount.get()) 

// grass remains 
return (new Grass(row, column)); 
el se 

// rabbits eat all the grass 
return (new Empty(row, column)); 

} 

public String toStringO { return "Grass"; } 
char toCharO { return f G f ; } 

Count getCountO { return neighborCount; } 
static Count neighborCount = new CountQ; 

} 

//Empty.java - representation of an empty cell 
class Empty extends Living { 

Empty(int r, int c) { row = r; column = c; } 

Living next(World world) { 
computeNeighbors(world); 
if (Rabbit.neighborCount.get() > 2) 
return (new Fox(row, column, 0)); 
else if (Grass.neighborCount.get() > 4) 
return (new Rabbit(row, column, 0)); 
else if (Grass.neighborCount.get() > 0) 
return (new Grass(row, column)); 
el se 

return (new Empty(row, column)); 

} 

public String toStringO { return } 

char toCharO { return '} 

Count getCountO { return neighborCount; } 
static Count neighborCount = new CountQ; 

} 

Note that, except for methods eden() and clearNei ghborCountsO in World, the classes Predator Prey, 
World, and Li vi ng are completely independent of the specific life-form classes. Hence we can easily add new 
life forms without changing the existing life-form classes. Here the only change required is to add a line for 
each new life form to the method clearNeighborCounts(). We also need to provide some way to get the 
new life forms into the world. We could do so either via eden () or via the rules in one or more of the existing 
life-form classes. For example, we might add a new class Cl over and modify the rules in class Empty to cre¬ 
ate Cl ove r if there is no thin g nearby. 

You may wonder why we didn’t place the code 

Count getCountO { return neighborCount; } 
static Count neighborCount = new CountQ; 

in class Li vi ng. These two lines appear, without change, in each of the classes derived from Li vi ng, so why 
not just put them in the superclass and let them be inherited? The problem is that we want one Count object 
for each class derived from Living. If we place the two lines of code in Li vi ng, there will be only one Count, 
not one for each derived class. Although we can’t create instances of an abstract class such as Li vi ng, the 
behavior of a static field in an abstract class is the same as a static field in other classes. Specifically, there 
will be only one instance of a static field, no matter how many instances of the class we create. The same 
restriction applies to both abstract and nonabstract classes. We leave the writing of toStri ng() and edenQ 
in the class Worl d for you to do as Exercise 12, on page 267. 
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7.8 INTERFACES 


Java has a classlike form called an interface that can be used to encapsulate only abstract methods and con¬ 
stants. Think of an Interface as a blueprint or a design specification. A class that uses this blueprint is a class 
that implements the interface. Another way of thinking of an interface is as a pure abstract class, wherein all 
implementation details are deferred. .An interface is allowed to have only abstract methods and constants. 
Interface methods can’t be static. 

Let’s consider a simulation like the one in the previous section. Suppose that not all life forms have the same 
notion of what it means to be a neighbor. For example, the neighborhood for a fox is probably different than 
that for a rabbit. If that’s the case, our superclass Li vi ng wouldn’t be able to implement computeNei gh- 
bors() for all derived classes. In this case we could use an interface instead of an abstract class. The inter¬ 
face for Li vi ng might be 

interface Living { 

Living next(World world); 
char toChar(); 

void computeNeighbors(World world); 

Count getCountO ; 

} 

An interface is allowed to have only pubhc methods, and by convention the keyword publ i c is omitted. 
Because all methods in an interface are abstract, the keyword abstract is also omitted. Implementing an 
interface is like extending an abstract class. A new class implementing the interface uses the keyword 
i mpl ements. The class that implements the interface must provide an implementation for all methods in the 
interface. When we use this interface instead of the earlier abstract class, our class Fox might become 

//Fox.java - prey class 
class Fox implements Living { 

// everything will be the same as before with the 
// addition of the following and changing 
// all methods from Living to be public 

// now each life form must provide this method 
// each can do it differently 
public void computeNeighbors(World world) { 
world.clearNeighborCountsO ; 
world, cells [row] [column] .getCountO . set(-l) ; 
for (int i = -2; i <= 2; i++) 
for (int j - -2; j <= 2; j++) 

if (row + i > 0 && row + i < world, cel Is. length && 

column + j > 0 && column + j < world.cel 1 s[0] .length) 

{ 

world, cells [row + i] [column + j]. getCountO . i nc() ; 

} 

} 

// an interface doesn’t contain data fields 
// so row and column must be declared here 
// we can now make these members private 
private int row, column; 

} 

Note that we changed the neighborhood of a fox to be a 5 x 5 neighborhood from the 3 x 3 neighborhood 
used earlier. Other life forms might have the earlier 3x3 neighborhood or something different. Because 
we’re using a larger neighborhood, we also added code to be sure that we don’t go beyond the bounds ol the 

array. 
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Of course, we could have overridden the definition of computeNei ghbors () in the class Fox, even when it 
was derived from the earlier abstract class Li vi ng. In this example, there is no particular advantage to using 
an interface rather than an abstract class. However, the difference between an interface and an abstract class 
becomes very important when you want to create a class that implements more than one interface. You can’t 
extend more than one class, but you can use a class to implement many interfaces, in addition to extending 
one class. 

We use interfaces extensively when we discuss graphical user interfaces in Chapter 8, Graphical User Inter¬ 
faces: Part I. In the next section we present a brief example in which abstract classes can’t be used but inter¬ 
faces can. 



7.9 MULTIPLE INHERITANCE 


Let’s revisit the tracking system for a university presented earlier in this chapter. The system contains 
records for students, faculty, and staff. Some parts of the system operate only on student records, others 
only on faculty records, and so on; some parts operate on the records for any type of person. As described so 
far, the system might be modeled with a type hierarchy like the one shown in the following diagram. 



What happens when a student is also a staff member? We could create two records for the person—a student 
record and a staff record—but that could cause problems. Parts of the system dealing with person records 
might treat the staff record and the student record as two different people. 

We need the ability to create a single record that sometimes can be treated as a student, sometimes as a per¬ 
son, and sometimes as a staff member. We can use interfaces to create such a record. Our university record 
system then might include the following interfaces. 

//Person.java 
interface Person { 
void setAge(int age); 
void setCender(char gender); 
void setName(String name); 
int getAge(); 
char getGender(); 

Stri ng getNameQ ; 

} 

//Student.java 

interface Student extends Person { 
void setCol1ege(String college); 
void setCpa(double gpa); 
void setYear(byte year); 

String getCollege(); 
double getGpaO ; 
byte getYear(); 

static enum YearlnSchool { frosh, sophmore, junior, senior} 


} 
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//Staff.java 
import java.util.Date; 
interface Staff extends Person { 
void setSalary(double salary); 
void setStartDate(Date start); 
void setEndDate(Date end); 
void setSSN(String ssn); 
double getSalaryQ ; 

Date getStartOate(); 

Date getEndDateC); 

Stri ng getSSNQ ; 


An interface can extend another interface, and an interface can include static final data members. However, 
an interface can’t include other types of data members. For this reason, the keywords stati c and f i nal on 
the data member declarations in interface Student could be omitted, just as we omitted publ i c and 
abstract from the methods in an interface. When we use interfaces, we don’t inherit method implementa¬ 
tions, only their specification. We can now create classes that implement these various interfaces. The follow¬ 
ing class can be used to store student employee records, something we couldn’t do before. 

import java.util.Date; 

class StudentEmployee implements Student, Staff { 

// methods required by Person 
public void setAge(int age){...} 
public void setGender(char gender){...} 
public void setName(String name){...} 
public int getAge(){.. 
public char getGender(){...} 
public String getNameO{ . ..} 

// methods required by Student 

public void setCol1ege(String col 1ege){...} 

public void setGpa(double gpa){...} 

public void set¥ear(byte year){...} 

public String getCol1ege(){...} 

public double getGpa(){...} 

public byte getYear(){...} 

// methods required by Staff 

public void setSalary(double salary){...} 

public void setStartDate(Date start){...} 

public void setEndDate(Date end){...} 

public void setSSN(String ssn){...} 

public double getSalary(){...} 

public Date getStartDate(){...} 

public Date getEndDateC){...} 

public String getSSNQ{ . ..} 

} 

Of course, the method bodies must be filled in, but the preceding example clearly shows that multiple inter¬ 
faces can be implemented. This approach is different from extending a class because only a single class can 
be extended. Some OOP languages permit multiple inheritance of classes, but various subtle complexities 
arise when code is inherited directly from several different classes. The developers of Java decided to avoid 
those complexities by not permitting multiple inheritance of classes. However, many of the programming 
problems that might otherwise be solved with multiple inheritance of classes can be solved by using Java's 
multiple inheritance of interfaces. Note that we are talking about multiple Inheritance from more than one 
immediate superclass. Multiple inheritance means more than simply having multiple superclasses. For exam¬ 
ple, if Student extends Person and Person extends Object, that isn’t multiple inheritance. Only when a 
class directly extends two or more classes is it called multiple inheritance, and only then do the problems 
that we’ve alluded to arise. 
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Instances of the class StudentEmployee can be passed to methods that expect as parameters any of Stu¬ 
dentEmployee, Student, Staff, or Person. Although we’ve gained the ability to create classes that imple¬ 
ment many different interfaces, we’ve given up some degree of code reuse. Hence, we need to provide 
implementations of methods such as setAgeO in every class that Implements the interface Person, directly 
or indirectly. The class StudentEmployee implements the Person interface indirectly because StudentEm¬ 
ployee implements Student and Student extends Person. 


Common Programming Error 

You can use interfaces just like classes when declaring variables or formal parameters. The key differ¬ 
ence is that you can’t actually create an instance of an Interface. For example, for the interface declara¬ 
tions in the preceding code, the following statement would generate a syntax error. 

Staff staff = new Staff(); // illegal 

But this statement is legal: 

Staff staff = new StudentEmployeeQ ; 

Of course, you should make such an assignment only if you expect later to have staff refer to some 
object that isn’t a StudentEmployee. Otherwise, you should declare staff to be type 
StudentEmployee. 



7.10 INHERITANCE AND DESIGN 


At one level, inheritance is a code-sharing technique. At another level it reflects an understanding of the 
problem; that is, it reflects relationships between parts of the problem space. Much of inheritance is the 
expression of an “is a” relationship between the superclass and derived classes. A student is a person. This 
relationship is the conceptual underpinning for making Person a superclass and allowing the behavior 
described by its public member functions to be interpretable on objects within its type hierarchy; in other 
words, subclasses derived from it share its interface. 


There is no way to specify a completely optimal design. Design involves trade-offs between the various objec¬ 
tives that a progra mm er wants to achieve. For example, generality is frequently at odds with efficiency. Using 
a class hierarchy that expresses “is a” relationships increases our understanding of how to compartmentalize 
coding relationships and potentially introduces coding inefficiencies by having various layers of access to the 
(hidden) state description of an object. However, a reasonable “is a” decomposition can simplify the overall 
coding process. For example, a shape-drawing package need not anticipate the need for future additional 


shapes. Through inheritance, the class developer implements the superclass “shape” interface and provides 

Tl ^ ■ T 1 m, -«■ // « m « _ _ _ _ 


code that implements operations such as “draw.” What is primitive or held in co 
Also unchanged is the client’s use of the package. 


mil 


on remains unchanged. 


An undue amount of decomposition imposes its own complexity and ends up being self-defeating. There is a 

granularity decision, where highly specialized classes don’t provide enough benefit and are better folded into 
a larger concept. 


Single inheritance (SI) conforms to a hierarchical decomposition of the key objects in the domain of dis¬ 
course. Multiple inheritance (MI) is more troubling as a modeling or problem-solving concept. In MI we are 
saying that the new object is composed of several preexisting objects and is usefully thought of as a form of 
each. The term mixin is used to mean a class composed via MI, whereby each inherited class is orthogonal. 
Much of the time there is an alternate “has a ” formulation. For example, is a vampire bat a mammal that hap¬ 
pens to fly, a flying animal that happens to be a mammal, or both a flying animal and a mammal? Depending 
on the code available, developing a proper class for vampire bat might involve an MI derivation or an SI 
implementation with appropriate “has a” members. Interfaces in Java generally take the form of mixins pro¬ 
viding “has a” relationships. In our example of the student employee, the interface Staff is essentially stat- 
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ing that a StudentEmployee object has a social security number, salary, and start-end dates. Staff doesn’t 
actually implement any of these fields. Nor are we inheriting any code from Staff. Instead, we are stating 
that some methods exist in any class that implements the interface. 



7.1 1 TYPE CONVERSIONS AND POLYMORPHISM 


Java provides several forms of polymorphism. In Section 5.13, The container ArrayListo, on page 150 we 
discussed a standard Java container class which utilizes parametric polymorphism. That is, the container can 
hold different types of objects and the type that they can contain is determined by a type parameter in the 
declaration of the container. 

Earlier in this chapter we saw another form of polymorphism using method overriding. Given a reference to a 
superclass object we can write a method that works for any subclass of that superclass. The behavior can 
actually vary from subclass to subclass by redefining (overriding) method definitions from the superclass. 

There are cases when neither of the earlier techniques provides the desired functionality. In this section we 
describe how the i nstanceof operator can be combined with explicit casts of nonprimitive types to achieve 
more control over polymorphic behavior. In addition we describe how Java can sometimes automatically con¬ 
vert between a primitive type and a reference type, allowing primitive values to be used where a reference 
type is expected. 


7.11.1 THE OPERATOR instanceof AND CASTING NONPRIMITIVE TYPES 

The operator i nstanceof can be applied to an object to determine its type. The operator returns a boolean 
value. An example is 

if (x instanceof Shape) 

// x is a Shape, act accordingly 
el se 

// x is not a Shape, act accordingly 

The i nstanceof operator is used when ordinary polymorphism with overridden methods is inappropriate. 
An example is 

if (x instanceof Point) 

System.out.println("Point has no area" + x); 
el se 

System.out.print!n("Area is " + x.areaQ); 

Here we’ve two behaviors: a polymorphic behavior for shapes, which involves computing their area, and the 
special case of poi nt not having an area calculation. 

In Section 2.10.2, Type Conversion, on page 32, we showed how to use casting to convert one primitive type 
to another. We can use the same syntax for casting one reference type to another; the type can be any Java 
type. Recall that a cast is a type enclosed by parentheses. The following example shows how to cast a Person 
object to a Student object, provided that the object is in fact a Student. In this example Student is our orig¬ 
inal class Student, not the interface Student. 

static void someMethod(Person person) { 

■ • ■ 

if (person instanceof Student) { 

Student student = (Student)person; 

// code to operate on Student object here 

} 


} 





















































7.11.1 The Operator instanceof and Casting Nonprimitive Types 219 

Not all casts are legal, and some Illegal casts can be detected by the Java compiler. Other illegal casts are 
detected at rim time, in which case a Cl assCastException error will be reported. Consider the following 
method which is expected to at least sometimes, but not always, be called with a reference to a Student. In it 
we use the classes Student and Person from Section 7.1, A Student “Is a”Person, on page 195, not the inter¬ 
faces Student and Person. 


static void someMethod(Person person) { 

// some code here that deals with person as a Person 
Student student = (Student)person; 

// some code here that deals with person as a Student 

} 

The above method will compile and run fine if called with: 

Student student = new StudentO; 
someMethod(student); 

However, if called with the following an illegal cast will be detected at run time resulting in an exception 
being thrown (see Section 11.1, Exceptions, on page 324). 

Person person = new PersonQ; 
someMethod(person); 


Because of this dynamic type checking, you can safely cast from a superclass to a subclass without violating 
the type safety of Java. That is, you can never treat an object as something it really isn’t. Recall that an object 
of Type A is also an object of Type B when Type B is any superclass of Type A. In the preceding example, a Stu¬ 
dent object is also a Person object and an Object object. 

By combining the operator i nstanceof and casting, we can operate on generic containers in a completely 
safe way. A generic container is a container, such as an array, that may contain different types of objects. 
You can use the operator i nstanceof to determine the type of the object stored in the container and then 
cast the object into the appropriate type. This choice is the proper one if you expect the object to be one of 
several different types and you can’t use ordinary polymorphism with overridden methods. Alternatively, 
you can try 7 to cast the object and then catch the exception, if there is one. (We discuss catching exceptions in 
Section 11 . 1 . 1 , Exception Handling with try and catch , on page 324.) This choice would be the appropriate one 
if most of the time you expected the object to be of one type, but on rare occasions other types are expected. 
We use the exception handling mechanism of Java to handle the exceptional case. As shown in the following 

example, you can create an array that contains both strings and numbers by using the classes Stri ng and 
Integer. 


// GenericArray.java - demonstrate 
class GenericArray { 

public static void main(String[] 
Object[] array = new 0bject[4] 

= "String 1"; 

= new Integer(1); 

= "String 2"; 

= new Integer(2); 


array[0] 
array[1] 
array[2] 
array[3] 


generic array container 
args) { 
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for (int i = 0; i < array.length; i++) { 
if (array[i] instanceof String) { 

String temp = (String)array[i]; 

System.out.println("Processing string " + temp); 

// do something appropriate for strings 

} 

else if (array[i] instanceof Integer) { 

Integer temp = (Integer)array[i]; 

System.out.println("Processing Integer " + temp); 

// do something appropriate for an Integer 

} 

el se { 

System.out.println("Unexpected type " + array[i]); 

// do something to handle unexpected cases 

} 

} // end of for loop 

} 

} 

The above example works because Stri ng and Integer are both subclasses of the primoridal Java class 
Object. This works with any hiearchy of types. Consider the standard Java classes, Integer and Float, 
which are both subclasses of the standard Java class Number. We can make an “array of Number” that will 
contain both Integer and Float objects. 

class MixedNumberArray { 

public static void main(String[] args) { 

Number[] mixedNumberArray = new Number[4]; 
mixedNumberArray[0] = new Integer(100); 
mixedNumberArray[1] = new Integer(200); 
mixedNumberArray[2] = new Float(3.3); 
mixedNumberArray[3] = new Float(4.4); 
for (Number n : mixedNumberArray) { 

System.out.print(n + ", "); 

} 

System.out.println(); 

} 

} 


7.11.2 AUTOMATIC BOXING OF PRIMITIVES 

Because there are many situations In which programmers need to store both numeric and non-numeric data 
in the same array, or different types of numeric data (e.g. i nt and float), starting with Java 5.0, the Java 
compiler will automatically convert primitive types to their standard wrapper classes. This automatic conver¬ 
sion to a reference type is sometimes called “automatic boxing.” Automatic boxing allows primitive values to 
be used where a reference type is expected. There is a standard wrapper class for each of the primitive types. 
The standard wrapper classes, found in java. 1 ang, are: Byte, Short, Integer, Long, FI oat, Doubl e, Bool - 
ean, and Character. Automatic boxing is shown in the following example, which is a modification of the pre¬ 
vious example. 

class MixedNumberArrayAutoBox { 

public static void main(String[] args) { 

Number[] mixedNumberArray = new Number[4]; 
mixedNumberArray[0] -'100; 
mixedNumberArray[1] = 200; 
mixedNumberArray[2] = 3.3; 
mixedNumberArray[3] - 4.4; 
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for (Number n : mixedNumberArray) { 

System.out.print(n + ", "); 

} 

System .out. pri rttl n() ; 

} 

} 

The output of both examples is: 

100, 200, 3.3, 4.4, 


7.1 13 AUTOMATIC UNBOXING OF PRIMITIVES 

Not only will the Java compiler automatically box a primitive value in a wrapper class when needed, it will 
also automatically unbox a wrapper when a primitive value is needed. Consider the standard Java class 
j ava. uti 1 . ArrayLi st<T>. You can use this generic class to create an array like container that automatically 
expands as necessary. It is tempting to try and write: 

Arraylist<int> intArray = new ArrayLIst<int>(); // illegal 

However, the type parameter in the ArrayLi st declaration must be a reference type, not a primitive type, 
thus the above example will not compile. 

You cannot use the ArrayLi st class to store primitive types. Prior to Java 5.0, to use an ArrayLIst with a 
primtive type such as i nt, you would have to explicitly wrap each primitive value in a wrapper class for stor¬ 
age in the ArrayLIst and explicitly extract the primitive value to get it back out. This looks like: 

import java.util.*; 

class ManualBoxing { 

public static void main(String[] args) { 

ArrayList intArray = new ArrayList(); 
intArray.add(new Integer(10)); 
intArray.add(new Integer(20)); 

int first = ((Integer)intArray.get(0)),intValue(); 
int second = ((Integer)intVec.get(l)) .intValueO ; 

System.out.println(first + ", " + second); 

} 

} 

However, with automatic boxing and unboxing, and the new parameterized types, we get the programming 
ease and clarity as if we were actually storing primitive i nt values in the ArrayLi st. Starting with Java 5.0, 
the above example can be abbreviated to: 

import java.util.*; 

class ArrayListOflnt { 

public static void main(String[] args) { 

ArrayList<Integer> intVec = new ArrayList<Integer>(); 

intArray.add(10); 
intArray.add(20); 
int first = intArray.get(0); 
int second = intArray.get(l); 

System.out.println(first + ", " + second); 

} 

} 

As the ArrayLi st declaration shows, the i ntArray is actually storing Integer objects, but this is hidden 
except in the declaration. 
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7.12 PROGRAMMING STYLE 


Inheritance should be designed into software to maximize reuse and allow a natural modeling of a problem. 
With inheritance, the key elements of the OOP design methodology 7 are as follows. 

OOP DESIGN METHODOLOGY 

1. Decide on an appropriate set of types. 

2. Design in their relatedness and use inheritance to share code. 

3. Use overridden methods to process related objects polymorphically. 

When overriding methods in a subclass, you should have the subclass method call the associated superclass 
method, if appropriate. The same is true for subclass constructors. The rationale is that this procedure main¬ 
tains a conceptual link between related pieces of code. Then, if the superclass method or constructor is 
changed, the subclass constructor or method is similarly updated. 

//in Person 

public String toStringO { 

return ("Name: " + name + ", Age: " + age + ", Gender: " + gender); 

} 

//in Student 

public String toStringO { 

return(super.toString() + "\n " + "College: " + college + 

", GPA: " + gpa + ", Year: " + year); 

} 

Now, if a change is made to how Person is converted to a Stri ng, that change is propagated automatically 
to Student. 



Summary 


Inheritance is the mechanism used to derive a new class from existing classes. That is, an existing class 
can be added to or altered to create a subclass. Through Inheritance, a hierarchy of related, code-sharing 
abstract data types (ADTs) can be created. 

A class can be derived from an existing class by using the keyword extends. The derived class is called a 
subclass. The class that it is derived from is called its superclass. 


U java classes are organized into packages. By default, classes in the same directory 7 are in the same, 
“unnamed” package. Classes can also be placed into a named package using the keyword package. 



The keywords public, private, and protected are available as accessibility modifiers for class mem¬ 
bers. A public member is accessible anywhere. A private member is accessible from other methods 
within its own class. A protected member is accessible from methods within its package and within any 
class immediately derived from it. If no access keyword is used this is called package access. A member 
with package access is accessible from any class in the same package. 
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# Constructors are never inherited. The default superclass constructor is called implicitly as the first state¬ 
ment in a constructor, unless an exphcit superclass constructor is called. To call a superclass constructor 
other than the default, no-args constructor, use the keyword super. A subclass is a subtype of its super¬ 
class. An object of the subclass can in many ways be treated as if it were the superclass type. A variable 
of the superclass type can reference objects of the subclass type. 

# Overriding is a mechanism to dynamically select at run time the appropriate method from among super¬ 
class and subclass methods. This ability to dynamically select a method appropriate to an object’s type is 
a form of polymorphism. 

# Inheritance provides for code reuse. A subclass inherits superclass code, and the subclass typically mod¬ 
ifies and extends the superclass. Inheritance also creates a type hierarchy. It allows for run-time selection 
of overridden methods. Facilities that allow the implementation of ADTs, inheritance, and the ability to 
process objects dynamically are the essentials of object-oriented programming (OOP). 

# An abstract method is one whose body is undefined. Such a method must be overridden in a subclass 
and given a concrete definition. In OOP terminology it is called a deferred method. A class that has 
abstract methods is an abstract class and must be declared as such. It is useful for the root class in a 
type hierarchy to be an abstract class. It defines the interface for its derived classes, but can’t itself be 
used to create objects. 

# Java provides the interface construct, which is similar to abstract classes. An interface can contain 
only abstract methods and static final fields. A class may implement multiple interfaces, in addition to 
extending one class. 

# Java provides wrapper classes for each of the primitive types. In addition, Java will automatically convert 
from a primitive type to the corresponding wrapper when necessary. This is called boxing. Java will also 
do the reverse and convert a wrapper type to its corresponding primitive type. This is called unboxing. 



Review Questions 


1. Inheritance allows the programmer to_code. 

2. A reason to have private fields is_. 

3. An abstract method has a declaration but doesn’t have_. 

4. Redefining the same method name in a given class is called over_. Redefining the same method name 

with the same signature in a subclass is called over_. 

5. .An interface can have abstract methods but can’t have_. 

6. A class can extend_class(es) and implement_interface(s). 

7. The keyword super can be used in two different ways. Give an example of each. Why is it needed? 

8. What is the principle of data hiding? 

9. Discuss pubhc, package, protected, and private access. Write a simple example that shows their differ¬ 
ences. 

10. Object provides an equal s Q method. In the following code what gets printed? 
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public class ReviewlO { 

public static void main(String[] args) { 

Integer m = new Integer(3), n = new Integer(3); 

System.out.println(m); 

System.out.println(m.equals(n)+ " : " + (m == n)); 

} 

} 

11. For the following class definitions, what is printed when the method mainQ in class Reviewll is exe¬ 
cuted? 

class ClassOne { 

public void print() { 

System.out.printlnC "ClassOne"); 

} 

} 

class ClassTwo extends ClassOne { 
public void print() { 

System.out.println( "ClassTwo"); 

} 

} 

class Reviewll { 

public static void main(String[] args) { 

ClassOne one = new ClassOneO; 

ClassTwo two; 

one.printC); 

one = new ClassTwoC); 

one.printC) ; 

two = (ClassTwo)one; 

two.print(); 

} 

} 

12. For the class definitions in the previous question, will the following code compile? If not, what error mes¬ 
sage results? If so, what does it print when executed? 

class Reviewl2 { 

public static void main(String[] args) { 

ClassOne one = new ClassOneO; 
one.print(); 

ClassTwo two = (ClassTwo)one; 
two.print(); 

} 

} 

13. For the class definitions in Review Question 11, will the following two classes compile? If not, what error 
message results? If so, what does it print when executed? 
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class ClassThree extends ClassOne { 
public void print () { 

System.out.println( "ClassThree”); 

} 

} 

class Reviewl3 { 

public static void main(String[] args) { 
ClassThree three = new ClassThreeQ ; 
three.print(); 

ClassTwo two = (ClassTwo)three; 
two.printO ; 

} 

} 



Exercises 


1. Add a constructor to class Person in Section 7.1, A Student “Is a” Person, on page 194, that allows all 
fields to be given initial values. Do the same for Student. 

2. Derive a class from Person in Section 7.1, A Student “Is a”Person, on page 194, that has fields appropri¬ 
ate to a staff member in a company. Call the class Employee. 

3. Derive a class from Student in Section 7.1, A Student “Is a”Person, on page 194 , called GradStudent. 
Add members for the graduate student’s department and thesis topic. Then write appropriate construc¬ 
tors. Include a toStri ng() method. 

4. Write a program with a method reducedFare() that takes one parameter of type Person. The method 
should return true if the age of the person is less than 12 or greater than 64. Test the method by calling 
it first with a Person object and then with a Student object, using the classes Student and Person in 
Section 7.1, A Student “Is a”Person, on page 194. This exercise shows you the importance of inheritance 
and polymorphism in using related types. 

5. If you’ve already studied arrays write a program that lexicographically sorts an array of students by their 
last name. You can recode Student to have a first name member and a last name member. 

6. Modify the program in the previous exercise to break ties by using the first name when there is more 
than one person with the same last name. 

7. Add a method hours () to class Timer in Section 7.6, Abstract Classes, on page 207, that returns the 
number of hours for a given value of a Ti me r object. 

8. Create a class Clock that is derived from Timer and has a member hours. Override the methods of 
Timer to manipulate, access, and print out hours, minutes, and seconds. 

9. Create a class CountBy3 that extends AbstractCounter and counts by 3s. 

10. Create a class CountByN that extends AbstractCounter to count by a designated value n. Let the user 
specify this value as part of the constructor. 

11. Implement the class Count needed by the Predator-Prey simulation in this chapter. 

12. Complete the definition of the class Worl d in Section 7.7, An Example: Predator-Prey Simulation, on page 
209, by writing the methods toStri ng() and eden(). One way to compute the garden-of-eden position 
is to use a random number to pick the type of life form that goes in each cell. 

13. Add a new life form to the Predator-Prey simulation. 
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14. Modify the method computeNei ghborsQ of the class Li vi ng to allow for up-dates of the border cells. 

15. Complete the Implementation of PredatorPrey by using the interface for Living, as described in Sec¬ 
tion 7.8, Interfaces, on page 214, instead of the abstract class Li vi ng in Section 7.7, An Example: Preda¬ 
tor-Prey Simulation , on page 210. Use at least two different notions of neighborhood when implementing 
countNeighborsQ in the various classes that implement Li vi ng. 

16. Add a method equal s () to the class Counter in Section 6.6, Adding Instance Methods: Class Counter , on 
page 165. This method should return true if the counters are set to the same value. Test your method 
and dynamic typing by using your new Counter class in the program Equal sTest in Section 7.5, Type 
Object and Inheritance , on page 205. 

17. Create a class Poi nt with two coordinates. Include a method 1 i neLength () that takes another Poi nt as 
a parameter and returns the length of the line segment connecting the two points (the parameter and the 
implicit point upon which the method was called). Extend Poi nt to create a class ThreeDPoi nt that also 
has a z coordinate. Overload the 1 i neLength () method in ThreeDPoi nt to work with a ThreeDPoi nt 
parameter. Discuss the advantages and disadvantages of having ThreeDPoi nt extend Poi nt versus hav¬ 
ing two independent classes. 
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The main program examples presented so far have obtained their input by reading keystrokes typed at the 
keyboard, and their output has been in the form of text, printed to the computer console. Most computer 
programs today, however, have a graphical user interface (GUI), which includes both a graphical output capa¬ 
bility and a pointing device to allow the user to select items on the computer screen. Java contains a com¬ 
pletely portable and reasonably easy to use graphical library. In early versions of Java, the collection of 
classes used for building graphical user interfaces was called the abstract window toolkit (AWT). It is still 
part of standard Java, but it has been expanded with a new collection of classes called Swing . This addition 
makes inclusion of a GUI in any Java program relatively easy. 


The standard Java packages, j ava. awt and j avax. swi ng, together contain a collection of classes that imple¬ 
ment a wide assortment of GUI elements. Although we can build GUIs by using only components from 
j ava. awt, because of the added power and flexibility that comes with the components in j avax. swi ng, we 
describe building GUIs with both AWT and Swing. Some examples of simple GUI elements are buttons, 
menus, and scrolling text windows. For some GUI elements, we can obtain the appearance and behavior we 
want by creating instances of standard Java classes. In other cases we need to create new components. Using 
inheritance (see Chapter 7, Inheritance) allows us to add our desired behavior to existing components. 


The objects that make up a GUI built with Swing are called components. Some components are containers 
that can be used to group and arrange several components. Some examples of predefined components are 
J Button, J Label, and ]Checkbox. The following screen shot shows the GUI for a sample Java program that 
uses two JLabel components, three JCheckBox components, and a JButton. All six of the components in 
this GUI are contained in a single J Frame, which forms the outline of the GUI. 
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Recall that one of the attractions of java is that special Java programs called applets can be distributed 
across the Internet and run inside an Internet browser such as Netscape or Internet Explorer. Applets essen¬ 
tially always have a graphical user interface. 

In this chapter we present the fundamental concepts used in building Java programs that include a GUI. At 
the end of the chapter we introduce Java applets. You may have already worked some with applets and Swing 
components in the optional exercises in earlier chapters. If you did any of those exercises, some of the mate¬ 
rial presented in this chapter will be a review for you. 
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8.1 "HELLO, WORLD!" BUTTON 


Our first GUI example is the graphical equivalent of the traditional “Hello, world!” program. 

//HelloButton.java 
import java.awt.Container; 
import javax.swing.*; 

class HelloButton { 

public static void main(String[] args) { 

JFrame frame = new JFrame("HelloButton"); 

Container pane = frame.getContentPaneO ; 

JButton hello = new JButton("Hello, world!"); 

pane.add(hello); 

frame.pack(); 

frame.setVisible(true); 

} 

} 

When run, this program creates a new window on your computer desktop titled Hel loButton. Inside the 
window will be a button labeled “Hello, world!” If you click the button, its appearance changes to show the 
button being pushed in and then released. Nothing else will happen. It looks like this. 



The window created for the GUI is too small to show the full title, Hel 1 oButton, which appears just as 
He. . .. We didn’t tell the program to do anything when you push the button. The only result that you see at 
the moment is the default behavior of an object of type JButton. Shortly, we show you how to get the button 
actually to do something. If you enlarge the window, you can see the full text of the title. 



Dissection of the Class Hell oButton 


I U import java.awt.Container; 
import javax.swing.*; 

The standard Java classes used so far have been from the package java. 1 ang. This package is automat¬ 
ically imported into every Java program. Thus you can refer to the classes In the package without having 
to tell tiie Java compiler that you’re doing so. ; or all other packages, whether standard Java packages or 
those you write yourself, you must use an import statement like the ones shown here to tell the Java 
compiler to look in the specified package for classes. You can either list the specific classes that you’re 
using from the package as we did for Contai ner, or you can use an asterisk to indicate to the compiler 
that it can use any of the classes from the specified packages as we did for the package javax. swi ng. 

# JFrame frame = new JFrame(”He1loButton"); 

Here we create a JFrame that corresponds to the window on the computer’s desktop. The string "Hel - 
loButton" is used to title the window. The class JFrame is from the package javax . swi ng. The fully 
qualified name of the class is j avax . swi ng. J Frame. Because we import j avax . swi ng. *, we can just 
use the name JFrame. In future discussions, we will use the fully qualified name of a class when we first 
introduce it, so you will know which package it is from. In subsequent usage of the class, we will use only 
the simple class name. 
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# Container pane = frame.getContentPane(); 

A container is a component to winch we can add other components. A J Frame is actually a container, but 
you shouldn’t attempt to add components directly to a 3 Frame. Instead, you should add all components 
to a special container in the JFrame. Use the method getContentPaneO to get a reference to the 
3 Frame’s special container. 

# JButton hello = new JButton(”Hel lo, world!”); 

Here we create a javax. swi ng. 3 Button object and give it a string that will be used as a label. The con¬ 
structor for JButton takes a single parameter, which specifies the label for the JButton. Because of the 
import statement at the beginning of the program, we can just use the simple name JButton. 

# pane.add(hello); 

The method add () in the class Contai ner is used to add a component to the J Frame’s content pane. 
This method is part of every container component. In this example we don’t tell the container how to 
arrange the components in the container or where in the container this particular component should be 
displayed. We show how to do so later. 

# frame.pack(); 

frame.setVisible(true) ; 

These two calls tell the J Frame to pack all the objects in the J Frame appropriately and then cause the 
window to show up on the screen. In this example there is only one visible component, the JButton, so 
the J Frame will adjust itself to be just large enough to hold the JButton. 



The initially displayed window was too small. However, we can change its size by applying the method set- 
Si ze () to the J F rame as follows. 

//remove frame. packQ -- use 
frame.setSize (300, 200); 

This methods sets the horizontal length of the window to 300 pixels and the vertical length of the window to 
200 pixels. Pixels are a standard unit for windowing and drawing components (see Section 8.5, Drawing with 
Swing , on page 237). The method pack() needs to be removed; otherwise, it will compress the window to the 
smallest size necessary 7 to display the frame contents. 



8.2 LISTENING TO EVENTS 


If you run the program Hel 1 oButton, the program won’t terminate, although mai n () has finished. You will 
need to use your computer’s facility for aborting programs to end the program. What was going on? 

Any program that uses Swing to create a window implicitly creates a separate thread of execution that enters 
into an infinite loop, looking for events such as mouse movement, button clicks, or key presses. It’s like hav¬ 
ing two workers on the job, one following the instructions in mai n () and the methods it calls and the other 
watching for events and calling various methods to respond to those events. This type of program is called 
event driven. Hence, once mai n () has finished, all program behavior is in response to events. 

All Swing components are event sources that can be observed or “listened to.” In order to do something when 
an event is generated at some source, you need to tell the source which object to notify when the event 
occurs. To do so, use the method addSomethingLi stener(), where Something is some event type. This event 
model is called a delegation model wherein specific objects are delegated the responsibility of handling spe¬ 
cific events. 
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By default, the J Button object In the preceding example responds to mouse clicks by changing its appear¬ 
ance. J Button objects are also the source of java.awt.event.ActionEvent objects. An ActionEvent is 
generated by a button whenever you click the button with the mouse. 

PRESS, PRESS, PRESS ... 



In order to do something when an event is generated, you need to tell the source of the event—for example, 
the ] Button in Hel loButton—where to send the event. Objects that can receive events are called listeners. 
Different types of events have different types of listeners. Objects that generate ActionEvents contain the 
method addActionLi stener() that indicates which object or objects should receive the events. The 
Acti onEvent listener must implement the java.awt. event. ActionEvent Listener interface. To imple¬ 
ment an interface, a class must define all the methods specified in the interface. Thus a class that imple¬ 
ments the ActionEventLi stener interface must contain an actionPerformedO method. (Recall our 
discussion of interfaces in Section 7.8, Interfaces , on page 214. Although helpful, you don’t have to read that 
section before proceeding with the remainder of this chapter.) 

Whenever you generate an ActionEvent by clicking a button, the actionPerformedO method for each 
Acti onEventLi stener that was added to the button is called with the Acti onEvent object as a parameter, 
as shown in the following diagram. 


ActionEventListener 



ActionEvent 



In the following program we show how to add a listener to our “Hello, world!” button. 

//HelloCoodBye.java - 
import java.awt.Container; 
import javax.swing.*; 
class HelloGoodBye { 

public static void main(String[] args) { 

JFrame frame = new JFrame("Hel1oGoodBye"); 

Container pane = frame.getContentPaneQ; 

JButton hello = new JButton("Hel lo, world! 1 '); 

GoodBye listener = new GoodByeC); 

hello.addActionListener(1istener); 

pane.add(hello); 

frame.packC); 

frame.setVisible(true); 

} 

} 

The class Hell oGoodBye is almost the same as Hel 1 oButton; the only difference is the addition of two lines. 
First, we create an instance of the class GoodBye, which we use to listen for action events from the button. 
Then we add the hstener as an action listener for the button, using 

hello.addActionListener(1istener); 

We have called addActionLi stener0 for the button, passing it a new GoodBye object. The missing piece is 
the class GoodBye, which we implement as 
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//GoodBye.java 

import java.awt.event.*; 

class GoodBye implements ActionListener { 
public void actionPerformed(ActionEvent e) { 
System.out.println("Goodbye!"); 

System.exit(0); 

} 

} 




Dissection of the C lass GoodBye 


• import java.awt.event 

We need to import an additional package, which contains the definition of the various event listener 
interfaces. Recall that interfaces are used to indicate that a class contains certain methods. In this exam* 
pie we use the interface ActionLi stener to indicate that GoodBye contains the method actionPer- 
formedQ. 

• class GoodBye implements ActionListener 

Here we indicate that the class GoodBye contains all methods specified in the interface Acti onLi s- 
tener. That is, we say that the class implements the interface ActionLi stener. 

• public void actionPerformed(ActionEvent e) { 

System.out.println("Goodbye!"); 

System.exit(0); 

} 

This method is called when the button is clicked. It prints a message and then forces the program to exit. 
In this example, the method doesn’t use the Acti onEvent parameter passed to the method. We use this 
parameter in later examples. 



To summarize, the following steps are needed to “listen” or respond to button presses. 

Listening to a Button Press 

1. Create a button with new 3 Button ("some label"). 

2. Get the Contai ner for the JFrame using getContentPaneQ. 

3. Add the button to the content pane of the 3 Frame with add (). 

4. Create a listener class by 

a) adding implements ActionLi stener to the class declaration and 

b) defining an acti onPerformed () method. 

5. Add the listener object to the list of listeners for the button by calling 

button.addActionLi stener (1 i stener), where button is a reference to the button created in 
step 1 and listener is a reference to an instance of the class created in step 4. 

As we stated at the beginning of this section, programs that use Swing implicitly create a separate thread of 
execution, which enters an infinite loop. When that infinite loop detects a mouse click with the cursor over a 
J Button, a specific method in the 3 Button object is called. This method in turn generates the Acti onEvent 
and calls the method acti onPerformed () of any listeners that have been added to the 3 Button. The follow¬ 
ing pseudocode is for the hidden internal loop. This loop is activated as part of starting up any program that 
uses Swing components. 
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Pseudocode for Swing event loop 

while(true) 

wait for next event; 
determine event type, call it T; 

determine GUI object where event occurred, call it 0; 
call appropriate method in each T listener added to 0; 
end while loop 



8.3 TEXT AND NUMERICAL INPIT 


We demonstrated the response to a mouse click on a button, but what about reading in numbers or strings? 
Textlnput is essentially the same as Hell oGoodBye, except that it reads from a text field. Instead of a 1 But¬ 
ton object, we create a javax . swi ng.JTextField object. When you type into the text field and then hit 
Return while the cursor is in the text field, an action event will be generated. The resulting Acti on Event 
object is passed to the method acti onPerformedO and can be used to determine what text is in the field. 
Here is the class Textlnput. 

//Textlnput.java 

import java.awt.Container; 

import javax.swing.*; 

class Textlnput { 

public static void main(String[] args) { 

JFrame frame = new 3Frame( M TextInput"); 

Container pane = frame.getContentPaneO ; 

JTextField input = new JTextField( n Edit this text then hit <return>"); 

Echo listener = new EchoQ; 

input.addActionListener(listener); 

pane.add(input); 

frame. packQ ; 

frame.setVisible(true); 

} 

} 

You can create an empty text field by specify mg the width of the field in characters, or you can specify some 
initial text, as in the preceding example. Here is what the initial display looks like. 



VS V> ' ■ 


Textlnput 



You can use the mouse to select the text in the window and type your own message. For example, you could 
change the window to the following. 
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If you hit Return after editing the text, the message you typed would appear on the console as 


os-prompt>java Textlnput 
Java programming is fun. 


The action listener we use is called Echo. 

//Echo.java 

import javax.swing.JTextField; 

import java.awt.event.*; 

class Echo implements ActionListener { 

public void actionPerformed(ActionEvent e) { 

JTextField source = (JTextField)e.getSourceQ ; 

String text = source.getTextQ ; 

System.out.println(text); 

} 

} 

The class Echo is s imil ar to the listener class Good Bye. However, instead of exiting, we echo whatever is in 
the text field by using println(). The class Act i on Event has a method that can be used to find the source 
of the event. The method getSourceO returns a generic reference that must be cast into a JTextFi el d. (We 
discussed generic references and this type of casting in Section 7.11, Type conversions and Polymorphism , on 
page 218.) This operation is safe in that Java generates an exception if the reference isn’t in fact referencing a 
JTextFi el d object. In this case, it is always a JTextFi el d because that’s the only object to which we are lis¬ 
tening. In more complicated programs we could use the operator i nstanceof (see Section 7.11, Type conver¬ 
sions and Polymorphism , on page 218) to determine the type of the object returned by getSourceQ. 

Once we have a reference to the JTextFi el d object, we can use its getText () method to retrieve the text. At 
this point, if we were expecting a number, we could use methods from the various numeric classes to parse 
the string into a number. For example, if we were expecting an integer, we could turn the variable text into 
an i nt with 

int value = Integer.parselnt(text.trimQ) ; 

As we discuss later in Section 10.3.1, Parsing Text Streams , on page 304, we use the method trimQ from 
class Stri ng to trim away any leading or tr ailin g white space. We need to do so because parselnt() gener¬ 
ates an exception if it gets any characters that aren’t part of the integer, including white space. 

Note that we have again created a program that never ends. You can combine the techniques from Echo, 
GoodBye, Hel 1 oGoodBye, and Textlnput to create a program that accepts text or numeric input and then 
quits when a button is clicked. We leave that for you to do as an exercise. 


Common Programming Error 

If you omit the cast in the method actionPerformedO, 

JTextField source = e.getSourceQ ; 

you get the syntax error message Expl 1 cit cast is needed to convert a java.lang.Object to 
javax. swi ng. JTextField. The method call e.getSourceO returns an Object, which holds the value 
for the event source. It must be properly cast to the type JTextFi el d. 
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8.4 USING SEVERAL COMPONENTS 


Most GUIs have more than a single button to chck or a single text field. As a result, we face two new ques¬ 
tions: How do we arrange the GUI components when there is more than one? How do we respond to events 
from several different components? 

To control the arrangement of GUI components, Java uses layout managers. A layout manager is an object 
that determines the location of components. One type of layout manager is implemented by the class 
java, awt. Gri dLayout. As the name implies, GridLayout arranges the components in a two-dimensional 
grid. We specify the number of rows and columns in the grid and then add the components, one at a time. 
Each new component is added into the next available cell in the grid. 

In the following program we use a Gri dLayout to arrange the components of a minicalculator, which is capa¬ 
ble of adding and subtracting two numbers. The program includes two buttons: one for adding and one for 
subtracting. The ActionListener determines which button is clicked. 

//MiniCalc.java - demo GridLayout 
import java.awt.*; 
import javax.swing.*; 
class Mini Calc { 

public static void main(String[] args) { 

JFrame frame = new JFrame("MiniCalc"); 

Container pane = frame.getContentPaneO; 

// create the major components 

JTextField firstNumber = new JTextField(20); 

JTextField secondNumber = new JTextField(20); 

JTextField result = new JTextField(20); 

JButton addButton = new JButton("Add"); 

JButton subButton = new JButton(”Subtract") ; 

// there will be 4 rows of 2 components each 
pane.setLayout(new GridLayout(4, 2)); 

// add all of the components to the content pane 

pane.add(new JLabel("Enter a number”)); 

pane.add(firstNumber); 

pane.add(new JLabel (’’Enter a number”)); 

pane.add(secondNumber); 

pane.add(new JLabel("Result")); 

pane.add(result); 

pane.add(addButton); 

pane.add(subButton); 

// setup the listener, listening to the buttons 

DoMath listener = new DoMath(firstNumber, secondNumber, result); 

subButton.addActionListener(listener); 

addButton.addActionListener(1istener); 

frame.pack(); 

frame.setVisibl e(true); 

} 

} 

The initial display looks like this. 
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Dissection of the Class MiniCalc 


# import java.awt.*; 
import javax.swirig.*; 
class MiniCalc { 

public static void main(String[] args) { 

JFrame frame ~ new 3Frame("MiniCalc”) ; 

Container pane = frame.getContentPaneO ; 

This program begins like our other GUI examples so far. The imports are needed because we use 3 F rame, 
JButton, JTextFi eld, and JLabel from the package javax . swi ng and Contai ner and Gri dLayout 
from j ava. awt. We create a 3 Frame, which is the top-level window, and get the content pane to which 
we add the other GUI components. 

# JTextField firstNumber = new JTextField(20) ; 

JTextField secondNumber = new 3TextField(20); 

JTextField result = new JTextField(20); 

JButton addButton = new 3Button("Add"); 

JButton subButton = new 3Button("Subtract"); 

Here we create the JButton and JTextField components that are to be part of the GUI. The JText¬ 
Field components are wide enough to display 20 characters. 

# pane.setLayout(new GridLayout(4, 2)); 

To have the content pane use a Gri dLayout manager, we must set the layout manager as shown. We dis¬ 
cuss two other layout managers, BorderLayout and FlowLayout, later. 

# pane.add(new JLabel("Enter a number")); 
pane.add(firstNumber); 
pane.add(new JLabel("Enter a number")); 
pane.add(secondNumber); 
pane.add(new JLabel("Result")); 
pane.add(result); 
pane.add(addButton); 
pane.add(subButton); 

We can now add the components to the grid. Instead of specifying a row and column number for each 
component, we simply add them one at a time. The components are added to the grid be ginnin g in the 
upper left comer, filling the rows from left to right, and moving to the next row when a row is full. Each 
of the JTextFi eld components is placed in a row with a J Label component, which is text that serves as 
a label. We haven’t bothered to save a reference to the J Label components in local variables because we 
don’t need to refer to the labels after we’ve added them to the GUI. 
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# DoMath listener = new DoMath(firstNumber, secondNumber, result); 
subButton,addActionListener(listener); 

addButton.addActionListener(1istener); 

Here we create an instance of the class DoMath. The constructor for DoMath is passed the three text 
fields, which it needs in order to perform its task. The DoMath listener object is added as an Acti onLi s- 
tener for both buttons. 

• frame.packQ; 
frame.setVisible(true); 

Now that we’ve added all the components to our GUT, we call pack(), which tells the J Frame to arrange 
the components according to the layout manager that we specified—in this case, a grid of four rows and 
two col umn s. Finally the 3 Frame is ready to be shown. 



We have now shown one way to control the arrangement of multiple components—with a Gri dLayout. We 
use the class DoMath to show how an object can listen to multiple buttons and determine which button was 
clicked. 


//DoMath.java - respond to two different buttons 

import javax.swing.*; 

import java.awt.event.*; 

class DoMath implements ActionListener { 

DoMath(JTextField first, JTextField second, JTextField result) { 
inputOne = first; 
inputTwo = second; 
output = result; 

} 

public void actionPerformed(ActionEvent e) { 
double first, second; 

first = Double. parseDouble(inputOne.getTextO .trimQ) ; 
second = Double. parseDouble(inputTwo.getTextO .trimQ) ; 
if (e.getActionCommandO .equals( u Add")) 

output.setText(String.vaiueOf(first + second)); 
else // must be the "Subtract" button 

output.setText(String.valueOf(first - second)); 

} 

private JTextField inputOne, inputTwo, output; 




Dissection of the Class DoMath 


• import javax.swing.*; 
import java.awt.event.*; 
class DoMath implements ActionListener 

This class uses JTextField from j avax . swi ng and Acti onLi stener and Acti on Event from 
java, awt .event. As with the other hstener classes that we’ve created, the class DoMath must imple¬ 
ment the interface ActionLi stener. 
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# DoMathQTextField first, JTextField second, JTextField result) { 

inputOne = first; 
inputTwo = second; 
output = result; 

} 

Previously, the listener classes have had no explicit constructors, relying on the default constructor. .An 
instance of DoMath needs references to the three text fields in the GUI—two for input and one for out¬ 
put. Each is saved in a private instance variable. 

# public void actionPerformed(ActionEvent e) { 

double first, second; 

first = Double.parseDouble(inputOne.getText().trim()); 
second = Double.parseDouble(inputTwo.getTextC).trim()); 

Regardless ol which button is clicked, we need to get the text strings from each of the input text fields 
and convert those strings to numbers. Here we chose to convert them to primitive doubl e values. The 
call i nputOne. getTextC) returns the Stri ng object corresponding to the text typed into the JText- 
Fi el d component. We use the method tri m() from the class Stri ng to eliminate any extraneous spaces 
a user may type before or after the number. This call isn’t required, provided the user doesn’t acciden¬ 
tally type any spaces in the text field. However, including it makes our program more robust, that is, less 
likely to generate an error when we could have given a normal response. The call Doubl e. parseDou- 
bl e (. . .) converts a Stri ng to a primitive doubl e value. 

# if (e.getActionCommandC).equals("Add M )) 

output.setText(String.valueOf(first + second)); 
else // must be the "Subtract" button 

output.setText(String. valueOf(fi rst - second)); 

The class ActionEvent defines the method getActionCommand(). When the event is generated by a 
button, this call returns the action command string associated with the button. By default, the action 
command string is the same as the label on the button. The action command string can be different from 
the label, if the method setCommandStri ng(), which is defined for the class JButton, is called. By test¬ 
ing the command string, we can determine which button was chcked. Once we know which button was 
clicked, we perform the appropriate operation and call output. setText() to set the text string dis¬ 
played in the output text field. The call Stri ng. val ueOf () is used to convert the doubl e value to a 
String, as required by setText (). 

$ private JTextField inputOne, inputTwo, output; 

Here we declare the private data members of the class that are initialized in the constructor. 




8.5 DRAWING WITH SWING 


We have shown how to create an application that uses a GUI containing label, button, and text field compo¬ 
nents. We have also shown how to respond to button press events and events generated when Return is hit in 
a text field. In addition to displaying and receiving text, GUI components are also available for displaying 
arbitrary images. Drawing in Java is always done on an instance of the class Graphi cs. We demonstrate 
shortly how to obtain an object on which to draw. 

Java uses a coordinate system that places the origin, (0, 0), in the upper left comer of the window, with posi¬ 
tive displacements being down and to the right. You draw rectangles by specifying the coordinates of the 
upper left corner of the rectangle and the rectangle’s width and height. All values are in units of pixels. A 
pixel short for picture element, is one dot on your computer’s screen. For a black and white image, each pixel 
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requires only one bit of storage: 0 for white and 1 for black. When you use more bits, each pixel can represent 
shades of gray or different colors. Eight or 16 bits per pixel, allowing for 256 or 65,536 (64K) colors, are com¬ 
mon today. 

In the following figure, the outer rectangle represents the border of the drawing window. Given a 
java.awt. Graphi cs object g, you would draw the inner rectangle with the call 
g. drawRect(50, 20, 100, 40). It is 50 pixels in from the left edge, 20 pixels down from the top, 100 pix¬ 
els wide, and 40 pixels high. The left (50) plus the width (100) gives the first coordinate of the lower right cor¬ 
ner (150). Similarly the top (20) plus the height (40) gives the second coordinate of the lower right comer (60). 



The class Graphi cs includes methods for drawing arcs, lines, ovals, and polygons. All but lines can be drawn 
in outline or filled in. You can also change the color, draw text strings, change the font used for text strings, 
and perform several other drawing-related operations. 

Drawing is normally done by extending the class J Component. As discussed in Chapter 7, Inheritance, you 
extend an existing class by adding additional methods to the original class or by overriding some of the 
methods that exist in the original class. Once you’ve created a class that extends JComponent, you simply 
add an instance of that class to a GUI. The class Star draws a starburst. The following simple program dis¬ 
plays the starburst in a J Frame. 

//StarTest.java - display a starburst 
import java.awt.*; 
import javax.swing.*; 

class StarTest { 

public static void main(String[] args) { 

JFrame frame = new JFrameC’StarTest"); 

Container pane = frame.getContentPaneO ; 

Star star = new StarQ; 
pane.add(star); 
frame. packQ; 
frame.setVisible(true) ; 

} 

} 

The preceding program is s imil ar to others that we’ve already presented. The only difference is that we add 
an instance of the class Star to the content pane instead of a 3Button or other standard Java component. 
The class Star is as follows. 

//Star.java - draws a starburst 
import java.awt.*; 
import javax.swing.*; 

import static java.lang.Math.*; // PI, cos(), sin() 
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class Star extends JComponent { 

protected void paintComponent(Graphics g) { 
double xl, x2, yl, y2; 
for (double angle = 0; angle < PI; 
angle = angle + PI / 16) { 

// compute coordinates of endpoints of a line 
// cosine and sine range from -1 to 1 
// multiplying by RADIUS changes the 
// range to be from -RADIUS to RADIUS 
// adding RADIUS gives the final range of 
// 0 to 2 * RADIUS 

= cos(angle) * RADIUS + RADIUS; 


} 


xl - 

yi - 

x2 = 

y2 = sin(angle + PI) 
g.drawl_ine((int)xl, 


sin(angle) * RADIUS + RADIUS; 
cos(angle + PI) * RADIUS +RADIUS 

* RADIUS +RADIUS 
(int)yl, (int)x2, 


(int)y2) ; 


} 


} 


// make the JComponent big enough to show the image 
public Dimension getMinimumSizeO { 

return new Dimension(2 * RADIUS, 2 * RADIUS); 

} 

public Dimension getPreferredSize() { 

return new Dimension(2 * RADIUS, 2 * RADIUS); 

} 

private static final int RADIUS = 100; 


The output of this program is 
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Dissection of the Class Star 


# import java.awt.*; 

import javax.swing.*; 

import static java.lang.Math.*; // PI, cos(), sin() 

Here we see an example of using a static import which will allow us to make unqualified use of the static 
members of the class Math. We use the constant PI, and the methods cos () and si n (). 

# class Star extends ^Component { 

The class 3 Component is a standard java component. By extending it, we create a class that already 
includes all the methods defined for 3 Component. This includes the methods required of every GUI com¬ 
ponent. 

# protected void paintComponent(Graphics g) 

The main t hing we need to do in our extension of 3Component is redefine the method pai ntCompo¬ 
nent (), which is where we issue any desired drawing commands. This method is called indirectly in 
response to the call to setVi sible(true) for the 3 Frame that will eventually contain this Star object. 
Note that pai ntComponent () is passed a reference to aGraphics object. As mentioned earlier, the class 
Graphi cs actually implements the various drawing methods. In this example we use only one method 
fromCraphics, the method drawLineQ. The Graphics object passed to pai ntComponent () is part of 
the 3 Component that we are extending. In fact all components have a Graphi cs object stored internally 
as a private field. The Graphi cs object itself isn’t a component, and therefore it can’t be added to a GUI 
or displayed. The Graphi cs object is part of the 3 Component, like the Stri ng object representing a 
name might be part of a Student object or like the Stri ng that is part of a 3 Button object. In the case 
of a Stri ng, the value is a collection of characters. In the case of a Graphi cs, the value is a collection of 
pixel values and various other parameters that we discuss later. The methods defined or Graphics 
allow us to modify those pixel values. 

# for (double angle = 0; angle < PI; angle = angle + PI / 16) { 

// compute coordinates of endpoints of a line 

// cosine and sine range from -1 to 1 

// multiplying by RADIUS changes the 

// range to be from -RADIUS to RADIUS 

// adding RADIUS gives the final range of 

// 0 to 2 * RADIUS 

xl = cos(angle) * RADIUS + RADIUS; 

yl = sin(angle) * RADIUS + RADIUS; 

x2 = cos(angle + PI) * RADIUS + RADIUS; 

y2 = sin(angle + PI) * RADIUS + RADIUS; 

g.drawLine((int)xl, (int)yl, (1nt)x2, (int)y2); 

} 

You don’t need to understand the mathematics in this example. The main thing to note is that there is a 
loop and that each iteration of the loop draws one line. The angle of the line drawn is changed with each 
iteration, resulting in the starburst of lines shown in the output. The calls to cos() and si n() statically 
imported from java. 1 ang .Math) compute values that correspond to two points on opposite sides of a 
circle with radius one and centered at the origin, (0, 0). The multiplication by RADIUS expands the lines 
to be 2 * RADIUS long instead of length 2. The addition of RADIUS is used to translate the lines so that 
the center of the imaginary circle is moved to the point (RADIUS, RADIUS). The ang 1 e is in radians ant; is 
the angle of the diagonal of the circle produced by connecting the two points. The method drawLi ne() 
takes four parameters: the x and y coordinates of the first point and the x and y coordinates of the sec¬ 
ond point, in that order. The parameters to d rawLi ne () must be integers, so we use an explicit cast to 
convert the doubl e values to i nt. 
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public Dimension getMinimumSize() { 

return new Dimension(2 * RADIUS, 2 * RADIUS); 

} 

public Dimension getPreferredSize() { 

return new Dimension(2 * RADIUS, 2 * RADIUS); 

} 


When the method packQ for a 3 Frame is called, for each component the layout manager of the content 
pane will call one of the methods getMi nimumSi ze() or getPreferredSizeQ. The choice of which to 
call depends on the layout manager and other factors. The value returned by this method call is used to 
adjust the size and placement of the component. The class 3Component includes definitions of these 
methods, but by default they simply return a Di mensi on value that is height equals 0 and width equals 
0. Here we redefine those methods so that the layout manager will provide enough area for our entire 
starburst image to show. The class Dimension is a standard Java class that simply encapsulates two 
integers, treated as the width and height. 



Common Programming Error 

In drawing applications you can easily get the dimensions wrong. If the size of the frame displayed on 
your screen is too small, important drawing details may be lost. In the preceding application, see what 
happens when the methods getMi nimumSi ze() and getPreferredSizeO are omitted. The resulting 
window won’t be large enough to display the star. You can use the mouse to enlarge the window so that 
the star will be displayed in full. 



8.6 THE LAYOUT MANAGER FlowLayout 


The layout manager Gri dLayout used by the class Mi ni Cal c earlier is fine if all the components are to be 
the same size. If the components need to be different sizes, a different layout manager must be used. Several 
different layout managers are standard classes in Java. The default layout manager for the content pane of a 
3 Frame is called BorderLayout. We discuss the class BorderLayout in Section 9.1.1, The Class BorderLay¬ 
out, on page 259. 

One of the simplest layout managers is java, awt .FlowLayout. It lays out the components in rows like lines 
of text, putting as many components as will fit in a single row. The rows of components can be aligned left, 
right, or center, just like lines of text. If the window is resized, the rows are adjusted accordingly. 

The following example uses a FlowLayout manager. The code shows the alignment being set to center when 
the FlowLayout is constructed. 

//FlowLayoutTest.java 
impo rt j ava.awt.*; 
import javax.swing.*; 

class FlowLayoutTest { 

public static void main(String[] args) { 

3Frame frame = new 3Frame( ,T FlowLayout.CENTER") ; 

Container pane = frame.getContentPane(); 

pane.setLayout(new FlowLayout(FlowLayout.CENTER)); 
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} 


} 


pane 

pane 

pane 

pane 

pane 


addCnew 
add(new 
add(new 
add(new 


add(new 
frame.setSize(300,100); 
frame.setVisible(true); 


JButton("Button 1")); 
ILabel("Label 2")); 
JButton("Button 3")); 
ILabel("Label Four (4) 
JButton("Button 5")); 


(i 


)); 


The following screen shot shows the output of the program. 
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Note that, unlike the arrangement with Gri dLayout, the components aren’t all the same width, and they 
don’t form nice columns. 

Using a FI owLayout, we can add a Quit button to our starburst drawing program as in 


//StarTestQuit.java 
import java.awt.*; 
import javax.swing, 
class StarTestQuit 
public static voi 
I Frame frame = 
Container pane 
Star star = new 


added a quit 


button to StarTest 


■ 

J 

{ 

d main(String[] args) { 
new JFrame("StarTest"); 

= frame.getContentPaneO; 
StarQ ; 


//Changes from StarTest are below here 
JButton quit = new JButton("Quit"); 
pane.setLayout(new FlowLayout()); 
quit.addActionListener(new GoodByeQ) ; 
pane.add(quit); 

//Changes from StarTest are above here 
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pane.add(star); 

frame.pack(); 

frame.setVisible(true); 

} 

} 

This program uses the class Good Bye discussed earlier. The changes from the earlier class StarTest are the 
lines that create the button, change the layout, add the listener to the button, and add the button to the con¬ 
tent pane. The following screen shot shows the output of the program. Clicking the Quit button causes the 
program to exit normally. 
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A SIMPLE DRAWING PROGRAM 


One of the earliest apphcations of a graphical user interface with a mouse involved using the mouse to draw 
on the screen. The following program allows us to draw on the screen by holding down the mouse button 
and “painting with the mouse.” The program consists of three classes: The class SimplePai nt contains 
mainO, creates the 3 Frame, and adds the drawing component to the frame; the class Drawl ngCanvas 
extends 3 Component; and the class Pai ntListener responds to mouse motion and draws on the canvas. The 
relationship between these three new classes and some of the standard Java classes used by this program 
can be visualized in the following UML diagram. The “#” symbol before some of the method names indicates 
that the methods are protected. The —> indicates a dependence relationship between the two classes. The 
line with a small circle at the end indicates that Pai ntLi stener implements the MouseMotionListener 
interface and the dashed arrow to the small circle from Drawi ngCanvas indicates that the Drawi ngCanvas 
depends upon the Pai ntLi stener but only knows about it as something that implements MouseMoti on Li s- 
tener. 



First, let’s consider the code for the class Si mpl ePai nt 
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//SimplePaint.java - a program to draw with the mouse 
import java.awt.*; 
import javax.swing.*; 
class SimplePaint { 

public static void main(String[] args) { 

IFrarne frame = new JFrame("SimplePaint"); 

Container pane = frame.getContentPane(); 

DrawingCanvas canvas = new DrawingCanvas(); 

PaintListener listener = new PaintListener(); 
canvas.addMouseMotionListener(listener); 

pane.add(canvas); 

frame.pack(); 

frame.setVisible(true); 

} 

} 

The class Si mpl ePai nt doesn’t need much explanation. It’s nearly identical to previous examples that cre¬ 
ated a JFrame. The main difference is that the listener this time is a java.awt.event.MouseMotionLis- 
tener, so we use the method addMouseMotionLi stener() instead of addActionLi stenerQ. We discuss 
shortly the interface MouseMoti on Li stener in the dissection of Pai ntLi stener. 

Next, let’s consider the code for the class Drawi ngCanvas. 

// DrawingCanvas.java - a blank Canvas 
import java.awt.*; 
import javax.swing.*; 

class DrawingCanvas extends ^Component { 
public Dimension getMinimumSizeO { 
return new Dimension(SIZE, SIZE); 

} 

public Dimension getPreferredSize() { 
return new Dimension(SIZE, SIZE); 

} 

private static final int SIZE = 500; 

} 

The only tiling we need to do in Drawi ngCanvas is to define the methods used to determine the size of the 
Drawi ngCanvas. There isn’t even a pai nt Component () method, so all the work of this program is done in 
Pai ntLi stener. 

Finally, let’s consider the code for the class Pai ntLi stener. 

//PaintListener.java - do the actual drawing 
import java.awt.*; 
import java.awt.event.*; 

public class PaintListener implements MouseMotionListener { 
public void mouseDragged(MouseEvent e) { 

DrawingCanvas canvas = (DrawingCanvas)e.getSource(); 

Graphics g = canvas.getGraphics(); 

g. fill Oval (e.getXO - radius, e.getYO - radius, diameter, diameter); 

} 

public void mouseMoved(MouseEvent e) {} 

private int radius = 3; 

private int diameter = radius * Z; 

} 

The following screen shot shows the output of one run of the program Si mpl ePai nt. We used our com¬ 
puter’s desktop facilities to reduce the size of the window to save space. When initially displayed, the win¬ 
dow was as tall as it is wide. 
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Dissection of the Class Paint Listener 


# import java.awt.*; 
import java.awt.event.*; 

public class PaintListener implements MouseMotionListener 

This class is similar to the other listener classes that we’ve created. However, it implements a different 
type of listener—a MouseMotionLi stener. The ActionListeners that we created were required to 
define the method acti onPerformed(). That method was called when the button was clicked or Return 
was hit in the text field. A MouseMoti onLi stener must define two methods: mouseMoved () and mouse- 
Dragged(). The method mouseMoved() is called when the mouse is moved without a button being 
pressed. The method mouseDragged () is called when the mouse is moved while a button is being held 
down. 

# public void mouseDragged(MouseEvent e) { 

DrawingCanvas canvas = (DrawingCanvas)e.getSourceO; 

Each time the mouse is moved™while positioned over the component that this listener is listening to— 
mouseDraggedQ is called. Each change in position detected by the system generates another call to 
mouseDraggedQ. In other words, a single stroke of dragging the mouse across the screen can result in 
many calls to mouseDragged(). Each call is passed a MouseEvent object that contains, among other 
things, a reference to the component that generated the event and the coordinates of the mouse at the 
time the event was generated. The call e. getSourceC) returns a generic reference to the component 
that generated the event. In general, the event could have come from any component, not just a Draw- 
i ngCanvas. Here we explicitly cast the reference into a reference to a Drawi ngCanvas object. 

# Graphics g = canvas.getGraphicsC); 

We can use the reference canvas to the Drawi ngCanvas object to obtain a reference to the Graphi cs 
object contained in the canvas. This Graphi cs object is analogous to the Graphi cs object that was 
passed to the method pai ntComponentQ in the class Star, which we discussed earlier. Although not 
explicitly defined in our class Drawi ngCanvas—because it extends 3Component—Drawi ngCanvas auto¬ 
matically includes the method getGraphicsC), inherited from 3 Component. 

# g. fill Oval (e.getXO - radius, e.getYO - radius, diameter, diameter); 

The MouseEvent parameter e contains the x and y coordinates of where the mouse was when the event 
was generated. We use getX() and getYQ to obtain those coordinates and then draw a small circle, of 
diameter 6, centered on those coordinates. To draw a circle we use the method fi 1 lOval (), which 
needs four i nt parameters. The first two specify the coordinates of the upper left comer of a rectangle. 
The last two specify the width and height of the rectangle. The oval is inscribed in the rectangle. By spec¬ 
ifying the width and height to be equal, we get a circle. If the center of the circle is at (x, y), then the 
upper left corner of the bounding box will be at (x - radius , y - radius ). 
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# public void mouseMoved(MouseEvent e){} 

Although we’re not interested in doing anything when the mouse is moved with the button up, a Mouse - 
Moti on Li stener is still required to provide a definition of the method mouseMovedQ. As shown here, 
the method does nothing. 

® private int radius = 3; 

private int diameter = radius * 2; 

To make the code more self-documenting and to make changing the size of the circle drawn easier, we 
capture the size of the circle in these two variables. 



A problem with the paint program just described occurs when a portion of the drawing surface is obscured 
by another window and then is brought back to the front. Any drawing done in the obscured area is lost; that 
portion of the window will be blank. 


If we want to be able to restore the obscured portion o\ the canvas, we need somehow to remember all the 
previous drawing operations. One approach would be to save all the coordinates of the points used for draw¬ 
ing the small circles. For example, we could save them in an array. Then we could add a pai ntComponentQ 
method to Drawi ngCanvas that would redraw all the circles, using the saved coordinates from the array. An 
alternative is to create an offscreen image of what was drawn, then we could add a method pai ntCompo- 
nent () to Drawi ngCanvas that transfers this offscreen image to the screen. Java provides direct support for 
the latter approach, and we demonstrate it in the following program. This program is almost the same as the 
SimplePaint program. It consists of three classes: Simp1ePaint2, Drawi ngCanvas2, and PaintListener2. 
The class Si mpl ePai nt2 is nearly identical to Si mpl ePai nt. The only difference is that the identifiers 
Drawi ngCanvas and Pai ntLi stener have been changed to Drawi ngCanvas2 and Pai ntLi stener2, so we 
don’t include it here. 


The class Drawi ngCanvas2 is as follows. 

//DrawingCanvas2.java - remember drawing operations 
// using an offscreen image 
import java.awt.*; 
iimport javax. swi ng. *; 

class DrawingCanvas2 extends JComponent { 

// transfer the offscreen image to the screen 
protected void paintComponent(Graphics g) { 
if (offscreenlmage != null) 

g.drawImage(offscreenlmage, 0, 0, SIZE, SIZE, null); 

} 

// return the graphics for the offscreen image 
//if one doesn’t exist create one 
public Graphics getCanvasGraphics() { 
if (offscreenlmage == null) { 

offscreenlmage = createImage(SIZE, SIZE); 
offscreenGraphics = offscreenlmage.getGraphicsQ; 

} 

return offscreenGraphics; 

} 

public Dimension getMinimumSizeQ { 
return new Dimension(SIZE, SIZE); 

} 

public Dimension getPreferredSize() { 
return new Dimension(SIZE, SIZE); 

} 
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private 

private 
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static final int SIZE - 500; 
Image offscreenlmage; 
Graphics offscreenGraphics; 
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Dissection of the Class DrawingCanvas2 

import java.awt.*; 
class DrawingCanvas2 extends JComponent { 

// transfer the offscreen image to the screen 
protected void paintComponent(Graphics g) { 
if (offscreenlmage != null) 

g.drawImage(offscreenImage, 0, 0, SIZE, SIZE, null); 

} 

If anything has been drawn, an offscreenlmage has been created. The method pai ntComponent () calls 
g. drawImageO to transfer the offscreen memory image to the computer’s screen. The first parameter 
for drawImageO is a reference to the offscreen image. The next two are the coordinates where the 
upper left corner of the image should be placed on the canvas. We are f illin g the entire canvas, so we 
place the upper left corner of the image at the upper left corner of the canvas, or (0, 0). The next two 
parameters are the width and height of the image as it will appear in the canvas-in this case the width 
and height of the canvas. Another time we might choose to stretch or shrink the image to fit a smaller 
rectangular area of the screen. We can do so by simply adjusting the width and height parameters in the 
call to drawImageO. The entire image is always drawn but is adjusted to fit the rectangle by either 
stretching or shrinking either or both the width and height. 

# public Graphics getCanvasGraphicsO { 
if (offscreenlmage == null) { 

offscreenlmage & createImage(SIZE, SIZE); 
offscreenGraphics=offscreenlmage.getGraphics(); 

} 

return offscreenGraphics; } 

This method is used by the listener to get a reference to the Graphi cs object associated with the off¬ 
screen image. The listener needs a reference to the Graphi cs object so that it can draw on the image. 
The first time that getCanvasGraphi cs () is called, the offscreen image is created by c allin g createlm- 
age(). The method createlmageO is implicitly defined for Drawi ngCanvas2 because it extends JCom- 
ponent and createlmageO is already defined in JComponent. This method is used to create an 
offscreen image suitable for transfer to a JComponent. We placed createlmageO here instead of in the 
Drawi ngCanvas2 constructor because, at the time the constructor is called, the JComponent may not yet 
be ready to create an offscreen image. Once the JComponent has been displayed on the screen, the 
JComponent is ready to create an image. Calling createlmageO in the constructor for Drawi ngCanvas2 
simply returns null. 

Users of Drawi ngCanvas2 are expected to draw with this off screenGraphi cs which will draw on the 
offscreen image. An Image object can’t be added to a GUI; it is simply a representation of an image in the 
computer’s memory. The Image object contains a Graphi cs object for the actual drawing, in the same 
way that the Drawi ngCanvas object contains a Graphi cs object for drawing on the screen. 

public Dimension getMinimumSize() 


■ ■ 


private Image offscreenlmage; 
private Graphics offscreenGraphics; 


The remainder of Drawi ngCanvas2 is the same as Drawi ngCanvas, with the addition of the two private 
instance variables offscreenlmage and offscreenGraphi cs. 









































































248 Graphical User interfaces: Part ! 

The class Pai ntLi stener2 is as follows. 

// PaintListener2.java - paints on an DrawingCanvas2, 

// and its associated offscreen image, 
import java.awt.*; 
import java.awt.event.*; 

public class PaintListener2 implements MouseMotionListener 

{ 

public void mouseDragged(MouseEvent e) { 

DrawingCanvas2 canvas = (DrawingCanvas2)e.getSource(); 

Graphics g = canvas.getCanvasGraphics(); 

g.fillOval (e.getXQ - radius, e.getYC) - radius, diameter, diameter); 
canvas.repaint(); 

} 

public void mouseMoved(MouseEvent e){} 

protected int radius = 3; 

protected int diameter = radius * 2; 

} 




Dissection of the Class Pai ntLi stener2 


# Graphics g = canvas.getCanvasGraphics(); 

g.fillOval(e.getXQ - radius, e.getYC) - radius, diameter, diameter); 

The first part of PaintListener2 is the similar to the first part of Pai ntListener, except for the name 
change and the call to getCanvasGraphi cs() intead of getGraphi cs(). We are now drawing on the 
Graphics object associated with the offscreen image of the canvas instead of directly on the 
DrawingCanvas2 object. 

# canvas.repaint(); 

After drawing on the offscreen image we need to notify the component to transfer the offscreen image 
to the screen. A call to repai nt () for any component will result in the underlying system calling pai n t ~ 
Component () as soon as possible. In this case pai ntComponent () will transfer the offscreen image to 
the screen. 

# protected int radius = 3; 
protected int diameter = radius * 2; 

In anticipation of extending Pai ntLi stener2 to add additional features (see Section 9.6, on page 328 , 
we changed the access modifier on these two instance variables to be protected. Thus any class that 
extends Pai ntLi stener2 will have access to these fields. We use this approach to add the ability to 
change the size of the circle drawn with each stroke of the virtual pen. 




8.8 APPLETS 


One of the attractions of Java is that a special type of Java program, called an applet, can be embedded in an 
HTML document. Recall that HTML is the notation used for creating documents for display in an Internet 
browser. Recall also that the name applet is derived from application , suggesting a “little application.” 
Although applets can be relatively small programs, there is no practical limitation on their size. 
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We place an applet in an HTML document by using an applet tag. Then when a browser displays the page con¬ 
taining that tag, the compiled applet is downloaded onto the computer where the browser is r unnin g and 
executed there. The output is displayed in the browser. The following simple HTML file contains an applet 
tag for the Mi ni Cal cAppl et discussed later in this section. 

<html> 

<body> 

Below is the beginning of an applet calculator. This calculator can be used only for 
addition and subtraction. You enter a number in each of the first two fields and then 
click either "Add” or "Subtract", You can continue to change the values in the first 
two fields. Whenever you want the new sum or difference computed, just click the 
appropriate button. 

<P> 

<center> 

<applet code="MiniCalcApplet.class" width=200 height=100> 

</applet> 

<P> 

MiniCalcApplet 
</center> 

</body> 

</html> 

Although the details of HTML are beyond the scope of this book, we provide a brief dissection of this small 
HTML file. 




Dissection of the File MiniCalcAppIet.html 


# <html> 

<body> 

These are two examples of HTML tags, all of which are set off with angle brackets. Most tags come in 
pairs with a beginning tag, such as <body>, and an ending tag, such as </body>. Although not strictly 
required, all HTML files should begin with an <html> tag, indicating that the file is in fact an HTML file. 
An HTML file can have several parts, but in this file there is only one major part: the body. 

# Below is ... 

<P> 

We place text in the HTML file by simply entering the text. To indicate a new paragraph we can use the 
paragraph tag, <p>. Unlike most tags, the paragraph tag doesn’t need a matching </p> tag. 

• <center> 

9 9 » 

</center> 

This pair of tags surrounds a section of the document, indicating that the browser should attempt to 
center the section horizontally on the page. 

• <applet code="MiniCalcApplet.class" width=200 height=100> 

This part of the file is the only part that you really need to understand for the time being. The beginning 
applet tag <applet> contains three named parameters: code, width, and height. All three of them are 
required, and each is assigned a value. As their names imply, they specify the name of the file that con¬ 
tains the applet code and the width and height of the screen area needed by the applet. In order to work 
correctly as specified here, the file MiniCalcApplet.class must be in the same directory as the file MiniCal- 
cApplet.html Then, when a browser fetches and displays MiniCalcApplet.html the browser will know to 
go back to the same place and look for the applet lie MiniCalcApplet.class and execute the program it 
contains. Because this tag is between the centering tags, the applet will appear centered in the browser 
window. 
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w <P> 

MiniCalcApplet 

We place a caption under the applet by starting a new paragraph and then entering the text of the cap* 
tion. This material is still between the centering tags, so this line is also centered horizontally. 

• </center> 

</body> 

</html> 


T hese tags are like closing parentheses. They mark the end of the centered section, the body of the doc* 
ument, and the entire document, respectively. 



The following screen shot shows the file MiniCalcApplet.html being viewed with the Hotjava browser. 
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Below is the beginning of an applet calculator. This calculator 
can be used only for addition and subtraction. You enter a 
number in each of the first two fields and then click either 
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the first two fields. Whenever you want the new sum or 
difference computed, just click the appropriate button. 
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HotJava Browser 


An applet is a Java class that extends either the class jav a. applet. Applet or the class j avax. swi ng. J Ap¬ 
plet. Because we are interested in using Swing components, we extend JAppl et. Unlike conventional Java 
applications, applets don’t have a mai n() method. Instead, an applet contains several methods that are 
called at appropriate times by the Internet browser that is viewing the HTML document with the embedded 
applet and hence executing the applet. 

The applet method i ni t () is probably the closest thing to mai n () in an application. The i ni t () method is 
called after the applet object has been constructed but before any other applet methods are called. Many 
operations that we might be tempted to place in a constructor for an applet belong in i ni 10 instead. We 
want to invoke operations of an applet in our method i ni t () that can’t be invoked until the applet has been 
fully constructed and possibly manipulated by the browser. 
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An appiet is like a J Frame in that it has a content pane that can contain Swing components such as buttons 
and text fields. The following code is our Mi ni Cal c application, redone as an applet. 

// MirtiCalcApplet.java 

/* <applet code=”Mi ni Cal cApplet .class" width=200 height=100x/applet> */ 
import javax.swing.*; 
import java.awt.*; 

public class MiniCalcApplet extends JApplet { 
public void init() { 

Container pane - getContentPaneO; 

// create the major components 

JTextField firstNumber = new JTextField(20); 

JTextField secondNumber = new JTextField(20); 

JTextField result = new JTextField(20); 

JButton addButton = new JButton("Add"); 

JButton subButton = new JButton("Subtract"); 

// there will be 4 rows of 2 components each 
pane.setLayout(new GridLayout(4, 2)); 

// add all of the components to the content pane 

pane.add(new JLabel("Enter a number")); 

pane.add(firstNumber); 

pane.add(new JLabel("Enter a number")); 

pane.add(secondNumber); 

pane.add(new JLabel("Result")); 

pane.add(result); 

pane.add(addButton); 

pane.add(subButton); 

// setup the listener, listening to the buttons 

DoMath listener = new DoMath(firstNumber, secondNumber, result); 

subButton.addActionListener(listener); 

addButton.addActionListener(1istener); 

} 

} 




Dissection of the Class Mini Cal c Applet 


• /* <applet code="Mi ni Cal cApplet .class" width^200 height=100x/applet> */ 

This comment contains an HTML applet tag suitable for displaying a Mi ni Cal cAppl et. Placing the 
applet tag in a comment at the beginning of the Java source file for the applet serves two purposes: First, 
it documents, with the applet source, appropriate values for the applet tag parameters; and second, as 
an aid in program development, the appletviewer program can be used to view applets outside a stan¬ 
dard browser. The program appletviewer can be passed the name of any text file cont ainin g an applet 
tag, and it will attempt to display the applet. Thus, on systems wherein Java programs are run from a 
command line, such as Unix and Windows, the following co mm and can be used to execute this applet. 
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appletviewer MiniCalcApplet.java 

Note that the source file Mi ni Cal cAppl et .java —not the compiled file Mi ni Cal cAppl et. cl ass —is 
given to appletviewer. We still have to compile the program before attempting to run it. We eventually 
want to create an HTML file, such as the one just dissected, MiniCalcApplet.html containing the applet 
tag for viewing with a Web browser. If we had already created the HTML file, we could also use it with 
appletviewer as in 

appletviewer MiniCalcApplet.html 

The program appletviewer won’t display the entire HTML document—only the applet portion. 

• import javax.swing.*; 
import java.awt.*; 

As with other Swing-based programs, we must import j avax. swi ng. * and java. awt. *. 

• public class Mini CalcApplet extends jApplet 

In our earlier Swing examples we often extended the class 3Component. Similarly, we can extend the 
class 3 Appl et to create Mi ni Cal cAppl et. As a result, our new class automatically contains definitions 
of all the methods defined for 3 Appl et. Many methods are required of all applets. Note also that this 
declaration of the class includes the modifier public. We’ve avoided using publ ic when it wasn’t 
required, which it hasn’t been for most of the classes created so far. When displayed inside a browser, 
the class Mi ni Cal cAppl et is instantiated inside another Java program that is part of the browser. There¬ 
fore the applet class must be declared to be publ i c. 

• public void initO { 

Container pane = getContentPaneQ; 

// create the major components 

3TextField firstNumber = new 3TextField(20); 

// code omitted in dissection - see listing above 
DoMath listener = new DoMath(firstNumber, secondNumber, result); 
subButtorv addActionListener(1istener); 
addButton.addActionlistener(1istener); 

} 

Note that the body of this method is almost identical to the body of mai n () in Mi ni Cal c in Section 8.4, 
Using Several Components , on page 234. Here are the changes. 

1. We deleted the first line, 3Frame frame = new 3Frame("MiniCalc") ; fromMini- 
Cal c. mai n (). The 3Appl et itself acts like the frame or top level window. 

2. We eliminated the last two lines from Mi ni Cal c .mai n(), pack() and setVisible(true). 
The browser that is running the applet takes care of packing and showing the applet when 
i ni t C) returns. 

This applet version of the program uses exactly the same listener class, DoMath. 



The preferred way to add graphical output to a 3Appl et is to add some appropriate component to the con¬ 
tent pane for the applet. For example, we could add an instance of the class Drawi ngCanvas2 in Section 8.7, 
A Simple Drawing Program , on page 246, to an applet, to create an applet you can draw on. The following 
program is the applet version of Si mpl ePai nt2 from Section 8.7, A Simple Drawing Program , on page 243. 

//SimplePaintApplet.java - applet version of program 
// that draws with the mouse 

/* <applet code="SimplePaintApplet.cl ass" width=500 height=500> </applet> */ 
import java.awt.*; 
import javax.swing.*; 
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public class SimplePaintApplet extends JApplet { 
public void init() { 

Container pane = getContentPaneO ; 

DrawingCanvas2 canvas = new DrawingCanvas2(); 

Paintlistener2 listener = new PaintListener2(); 
canvas.addMouseMotionListener(1istener); 
pane.add(canvas); 

} 

} 



8.9 PROGRAMMING STYLE 


In the examples presented In this chapter we used separate classes for each aspect of the programs they 
implement. For example, the program SimplePaintis represented by three classes. 

1. SimplePaint contains the method main(). 

2. Pai ntLi stener implements the mouse listener needed to do the drawing. 

3. Drawi ngCanvas extends JComponent, creating a new component class. 

Each of these classes is placed in a separate file, but all three could be placed in a single file. The only Java 
requirement is that there be no more than one public class per file. In general we recommend that you fol¬ 
low our examples and place each class in its own file. Doing so makes finding the definition of a class eas¬ 
ier—just look for the file with the corresponding name. Reusing the class in another program is also easier. 

In the following program, we incorporate all the functionality of the three classes from Simpl ePai nt into a 
single class. 

//SimplePaintCombined.java - combine all of the features of SimplePaint, 

// PaintListener, and DrawingCanvas into a single class. 

// This style of programming isn't recommended, 
import java.awt,*; 
import javax.swing.*; 
import java.awt.event.*; 

class SimplePaintCombined extends JComponent implements MouseMotionListener 

{ 

public static void main(String[] args) { 

JFrame frame = new JFrame("SimplePaint”); 

Container pane = frame.getContentPaneO ; 

SimplePaintCombined canvas = new SimplePaintCombined(); 

canvas.addMouseMotionListener(canvas); 

pane.add(canvas); 

frame.pack(); 

frame.show(); 

} 

public void mouseDragged(MouseEvent e) { 

SimplePaintCombined canvas = (SimplePaintCombined)e.getSource(); 

Graphics g = canvas.getGraphics(); 

g. fill Oval (e.getXO - 3, e.getYQ - 3, 6, 6); 

} 

public void mouseMoved(MouseEvent e) {} 

public Dimension getMinimumSizeO { 
return new Dimension(SIZE, SIZE); 


} 
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public Dimension getPreferredSize() { 
return new Dimension(SIZE, SIZE); 

} 

private static final int SIZE = 500; 


Although possibly convenient for small programs, this style of combining many distinct capabilities into a 
single class is generally a bad idea and should be avoided. Even more than combining multiple classes into a 
single file, combining many features into a single class can interfere with the ability to reuse parts of your 
programs. As shown in the minicalculator example, by creating the separate DoMath hstener, we were able to 
reuse the DoMath hstener class, with no changes , in our applet version of the minicalculator. 



Summary 


# java programs that use Swing use a delegation event model, involving event sources and event hsteners. 
The sources are components such as JButton and JTextField. The listeners implement one or more 
interfaces, which include methods that are called when particular events occur in the component. Once a 
hstener has been added to a component, the event delegation model calls the method in the hstener 
when the event occurs. For example, J Button objects are the source of ActionEvent objects. By adding 
an Acti on Li stener to a J Button object, whenever the button is pressed the actionPerformedO 
method of the ActionListener is called automatically, passing it an ActionEvent object. 

# Swing includes many GUI components. In the examples in this chapter, we used the Swing components 
JButton, JTextField, JLabel, and ^Component. 

# Although technically a component as well, J Applets aren’t normally added as components of a GUI. 
Instead, the 3 Applet is the top-level window, like I Frame. 

H All drawing is done on an instance of the class Graphi cs. This class includes methods for drawing rect¬ 
angles, ovals, and lines. Later we discuss methods for drawing arcs, polygons, and strings. 

f> All drawing routines in the class Graphi cs use a coordinate system that places the origin in the upper 
left comer of the component. Positive displacements are down and to the right. All distances are in pix¬ 
els. 

# We can draw on a component in one of two ways. The first approach is to extend an existing class, such 
as JComponent, and then redefine the method pai ntComponentO to do the desired drawing. The other 
approach is to obtain a reference to the Graphi cs object for the component by calling getGraphicsQ 
and then make the desired drawing calls with this Graphi cs object. However, with this approach, the 
drawing is lost if the component is obscured by another window. 

% The method getActionCommandQ can be used with the ActionEvent passed to an acti on Per¬ 
formed () method to determine which button was clicked. 

# A class that implements MouseMotionLi stener can be used to perform an action when the mouse is 
moved without a button being pressed, or is moved when a button is pressed. Moving the mouse with the 
button held down is called dragging. 

A Swing applet is a Java class that extends the class JAppI et. Instead of having a mai n() that creates the 
JAppl et object, applets are run by incorporating them into an applet viewer or Web browser. An HTML 
<applet> tag is used to place an applet in a Web page. The browser will create the JAppl et object and 
then call i ni t () to initialize the applet. 
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Review Questions 


1. In Hel 1 oButton the following three lines draw the window: 

pane.add(hello); 

frame. packQ ; 

frame.setVisible(true); 

Write comments for each of these three lines and describe the result to the window. 

2. What do each of the GUI elements 3 Frame, Contai ner, and 3 Button do? 

3. What method must be defined in order to implement the ActionListener interface? 

4. What steps do you need to perform to create a program that responds to button clicks? 

5. What event delivery model does Swing use? Describe it. 

6. What kind of event is generated byaJTextField when you hit Return? 

7. The call d rawRect (0, 0, 10, 10) will draw a 10 x 10 pixel square in which comer of the drawing area? 

8. How do routines such as pai ntComponent () and actionPerformedQ get called? 

9. What method gets called when the mouse is dragged? What kind of a listener would implement this 
method? 

10. What would happen if the methods getMinimumSize() and getPreferredSizeC) were deleted from 
the class Drawi ngCanvas in Section 8.7, A Simple Drawing Program , on page 244? 

11. What is the purpose of an applet tag? 

12. What method in an applet is most s imil ar to mai n () in a stand-alone application? 



Exercises 


1. Experiment with setSi ze () and determine the largest size of window that can be displayed on your sys¬ 
tem. 

2. Write or obtain a four-line poem, such as “Roses are red, Violets are blue, Coding is a test, Java is best,” 
by Anon. Then display it in a window with an appropriate title. (Hint You may want to use the following 
code.) 

// there will be 4 rows of 1 component 
pane.setLayout(new GridLayout(4, 1)); 

3. Use an array of Stri ngs to store the poem in the previous excercise in N lines. Use an array of UText- 
Fi el d objects to display the poem. 

4. Write a passive window for displaying the results of a computation of two or more arguments. The win¬ 
dow should have an appropriate title such as “Roots of a quadratic.” It would display the quadratic and 
then have two result boxes for the potentially distinct roots. 
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5. Redo the previous exercise to include event listeners. They should allow the user to select arguments and 
display the results. In the case of a quadratic equation, new coefficients would be input and a mouse 
click or other event would cause the result to be displayed. 

6. Write a program with a window that takes as input a string. Then parse the string into words and display 
each individual word in its own text box. Assume that the string will have no more than eight words. 


7. Modify the program in the previous excercise so that the words are displayed in alphabetical order. 

8. Modify Mi ni Cal c in Section 8.4, Using Several Components , on page 234, to include additional buttons 
for multiplication and division. 

9. Modify MiniCalcin Section 8.4, Using Several Components , on page 234, to operate more like a conven¬ 
tional infix calculator. In Mi ni Cal c, the only way to add three numbers is to add the first two, copy the 
answer in the result field into one of the input fields, and put the third number in the other input field. 
Instead, your calculator program should have a single JTextFi eld that is used for both input and out¬ 
put. Your calculator will need an Equal s button and buttons for each of the arithmetic operators. For 
example, to add three numbers you would enter the first number and click the Add button (nothing 
would appear to change). You would then enter the second number and click the Add button again; this 
time the sum of the first two numbers should be displayed. Finally you would enter the third number 
and click Equal s to display the sum of the three numbers. 



Instead of having it add and subtract, revise Mi niCalc to produce the greatest co: 
integers. 


Hill 


Lon divisor of two 


11. Redesign the Mi ni Cal c program to perform an arbitrary function of two arguments. The constructor for 
the new Mi ni Cal c should take a parameter of type Function where Function is the following interface. 


interface Function { 

double eval(double x, double y); 

} 

For example, to have the new Mi ni Ca l c perform addition, you could pass it a reference to an instance of 


class MyAdder implements Function { 
double eval(double x, double y) { 
return x + y; 

} 

public String toStringO { 
return "add”; 

} 

} 

The classes the implement Function should include a method toStri ng() so that the calculator can 
display the name of the function. 

12. Use a GridLayout to create a 3 Frame with three buttons along the diagonal. You can use 
new Label ("") to create an apparently empty grid position. 

13. Rim the FlowLayoutTest program, using all three alignment parameters. Use your normal desktop 
mechanism for resizing the window and observe how the components are moved around. 

14. Create a Tic-Tac-Toe board with a 3 x 3 grid of buttons. Create an Acti onLi stener that changes the but¬ 
ton label to an X or an O when it is clicked. The ActionLi stener should remember whether the next 
click is an X or an O. Initially, all the buttons should have blank labels. If e is the parameter passed to the 
method actionPerformedO, then you can use e.getSourceQ to get a reference to the button that was 
clicked. You can then use setLabel () from the class 3 Button to change the label. You should have only 
one Acti onLi stener, which listens to all the buttons, not one listener per button. Display your Tic-Tac- 
Toe board in an application or an applet. 


15. Using the GUI from the previous exercise, write a program to play Tic-Tac-Toe with the computer as one 
of the players. 
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16. Add a Cl ear button to the program Si mpl ePai nt that paints the entire window white. If graphics is an 
instance of Graphics, then 

g raphics.setColor(Col or.white); 

will do all subsequent drawing in white until changed. You will need to use Col or. bl ack to set the draw¬ 
ing color back to black. The call 

graphics.fi1lRect(left, top, width, height); 

will draw a filled-in rectangle. 

17. Modify the program Si mpl ePai nt to include a button that toggles between painting in black and paint¬ 
ing in white. Think of painting in white as erasing. The previous exercise shows how to change the color. 

18. Modify the program SimplePaint to include buttons for selecting several different pen widths. You 
change the width of the pen by changing the size of the circle drawn when the mouse motion is detected. 

19. Instead of having many different buttons to select different pen widths, as described in the previous 
exercise, modify SimplePai nt to use a JComboBox object. The class JComboBox is described in Section 
C.2, The Class JComboBox, on page 435. When the user chcks and changes the item selected by the JCom¬ 
boBox object, an ItemEvent will be generated. The ItemListener interface specifies one method: i tem- 
StateChangedC). This method is passed one parameter: an ItemEvent. Calling the method getltemQ 
for the ItemEvent object returns the string associated with the selected item. 

20. Write a program to play a number guessing game as described in Section 5.7, Searching an Ordered 
Array ; on page 133. Use a GUI that includes a text field to show the computers current guess and three 
buttons labeled Correct, Too Bi g, and Too Smal 1 . As an added feature, allow the user to specify the ini¬ 
tial range before generating the first guess. You can do so with two additional text fields. Be sure to use 
labels on the text fields to make your program easy to use. After the user chcks the Correct button, the 
game should start over. 

21. Use the following interface, HasCanvasGraphi cs, to rewrite SimplePaintApplet and SimplePaint2 to 
use the new hstener class Pai ntCanvasLi stener. The class Pai ntCanvasLi stener will be similar to 
Pai ntLi stener2, but the occurrences of Drawi ngCanvas2 will be replaced with HasCanvasGraphi cs. 

import java.awt.*; 
interface HasCanvasGraphics { 

Graphics getCanvasGraphics(); 

} 
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In Chapter 8, Graphical User Interfaces: Part I we Introduced the basics of creating graphical user interfaces 
with standard Java classes from the packages java. awt and javax. swi ng. In this chapter we describe some 
additional capabilities that you can use to build GUI-based applications. 


A complete discussion of the features and GUI components that are part of Swing would require an entire 
book. Instead of describing additional Swing components, in this chapter we focus on additional capabilities 
that you can use to create quality applications. For example, using only the material from the previous chap¬ 
ter, you’d have very limited control over the arrangement of components in the GUI for your application. 
Most applications today use a menu bar with cascading menus. The applications often contain several panes 
or areas in which you can do various things. They often use tool bars, which are collections of buttons, in 
addition to menus. Many applications can also be resized, with the GUI components adjus tin g themselves to 
the window size selected by the user. 



9.1 ARRANGING COMPONENTS IN A GUI 


We introduced the class Gri dLayout in Section 8.4, Using Several Components , on page 234 and FI owLayout 
in Section 8.6, The Layout Manager FlowLayout, on page 241. You can use them to arrange components in a 
container such as the content pane obtained from either a JFrame or a 3 Applet. .Another common layout 
manager is the BorderLayout. In fact, it is the default layout manager for both J Frame and JApplet. To 
obtain more sophisticated layouts, you can nest containers inside other containers, associating a different 
layout manager with each container. We will demonstrate this below. 


9.1.1 THE CLASS BorderLayout 

The class java.awt. BorderLayout allows for placement of as many as five components in a container—one 
in the center, and one on each of the four borders, hence the name BorderLayout. The following simple pro¬ 
gram demonstrates the use of BorderLayout. 

//BorderLayoutTest.java 

import java.awt.Container; 

impo rt j avax.swing.*; 

import static java.awt.BorderLayout.*; 
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class BorderLayoutTest { 

public static void main(String[] args) { 

JFrame frame = new 3Frame("BorderLayout") ; 
Container pane = frame.getContentPaneO; 
pane.add(new 3Button("North Button"), NORTH); 
pane.add(new 3Button("South Button"), SOUTH); 
pane.add(new JButton("East Button"), EAST); 
pane.add(new 3Button("West Button"), WEST); 
pane.add(new 3Button("Center Button"), CENTER); 
frame,pack(); 
frame.setVisible(true); 

} 

} 

The display for this program is 
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BorderLayout 


This program doesn’t set the layout manager for the content pane because BorderLayout is the default. 
Recall that FlowLayout and Gri dLayout required only a single parameter when calling the add() method 
for the associated container. However, when adding a component to a container using BorderLayout, you 
must pass in a second parameter that indicates where to place the component. The constant NORTH is defined 
in the class BorderLayout and is used in this example by virtue of the static import at the top of the file. 
Similar constants are defined for the other locations, as shown in the program. 


9.1.2 NESTING CONTAINERS IN OTHER CONTAINERS 

Suppose that we want a panel of buttons down the left side of the GUI, with a large display area in the center 
for either text or graphics. Let’s use the center to display the star that we drew in Section 8.5, Drawing with 
Swing , on page 238. We can then nest containers, as follows. 

//Nesting.java - nest a JPanel container in a JFrame 

import java.awt.*; 

import javax.swing.*; 

import static java.awt.BorderLayout.*; 

class Nesting { 

public static void main(String[] args) { 

JFrame frame = new 3Frame("Nesting containers"); 

Container pane = frame.getContentPaneO ; 

JPanel panel = new JPanelO; 

panel.setLayout(new GridLayout(4, 1)); 

panel,add(new 3Button("0ne")); 

panel,add(new 3Button("Two")); 

panel,add(new 3Button("Three")); 

panel,add(new 3Button("Four")); 

pane.add(panel, WEST); 

pane.add(new Star(), CENTER); 

frame,pack(); 

frame.setVisible(true); 

} 

} 


s*. 
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The display for this program is 
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Nesting containers 


In this example we used a javax . swi ng . J Panel , which is a type of container, to contain the four buttons. 
We set the layout manager for the 3 Panel to be a Gri dLayout with a single column of four rows. We then 
added the buttons to the J Panel instead of directly to the content pane of the j Frame. Finally, we added the 
3 Panel as a single component to the west border of the main content pane. 

In the preceding two examples, the buttons were resized to just fill their allotted spaces. The BorderLayout 
layout manager always attempts to adjust the sizes of the components to fill the space. likewise, the Gri d- 
Layout layout manager also attempts to fill each grid cell completely. Not all layout managers do so. For 
example, the program using a FlowLayout in Section 8.6, The Layout Manager FlowLayout, on page 241 
doesn’t expand the buttons to fill the available space. 

This process of grouping components in a container and then adding the container to another container can 
be repeated as much as necessary to achieve the desired arrangement of components. 
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9.2 GETTING A COMPONENT TO RESIZE 


Although some layout managers attempt to resize a component, the components that we have created so far 
by extending an existing component have had a fixed size. The classes Star and Drawi ngCanvas are two 
such examples. The size of the components derived from JComponent is determined by the size returned by 
the methods getMinimumSizeO and getPreferredSizeQ defined in the classes. If the window manager 
attempts to resize a component such as Star or Drawi ngCanvas, the resizing will be ignored. For example, if 
we use the mouse on our computer to adjust the size of the window for the program Nesting previously 
described, we get the following display. 
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Nesting containers 


We used the mouse to make the window shorter. The result is that part of the starburst is cut off. Note that 
the buttons were properly resized to just fill the space. We can modify the class Star so that when the user 
attempts to resize the window, the starburst will be redrawn to fit inside the new window. The program for 
this new class, Star2, is as follows. 
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//Star2.java - draws a resizable starburst 

import java.awt.*; 

import javax.swing.*; 

import static java.lang.Math.*; 

class Star2 extends JComponent { 

public void paintComponent(Graphics g) { 

// exactly the same as Star except RADIUS was 
// replaced by radius 
// omitted to save space 

} 

public void setBounds(int x, int y, int width, int height) { 
radius = min(width, height) / 2; 
super.setBounds(x, y, width, height); 
repaint(); 

} 

// make the Canvas just big enough to show the image 

public Dimension getMinimumSizeO { 

return new Dimension(2 * radius, 2 * radius); 

} 

public Dimension getPreferredSize() { 

return new Dimension(2 * radius, 2 * radius); 

} 

private int radius = 100; 

} 

The only modifications made in Star to obtain Star 2 were to change RADIUS to radi us, make radius a vari¬ 
able instead of a constant, and add the method setBounds(). 

The following display is generated by this program. The original display for Star2 is the same as the one for 
the original StarinNesting. But now when we shrink the window, the starburst is made smaller also. 





Dissection of the Method set Bounds () for Star2 


# public void setBounds(int x, int y, int width, int height) 

The method setBoundsQ is defined for ^Component (and all components). It is called by the layout 
manager for the container that holds a component to tell the component where it is being placed and 
how much of the screen it is being given. The method is passed the location of the upper left corner, of 
where the layout manager is moving the component. The method is also passed the widt h and height of 
the rectangular area that the layout manager has allocated for the component. By overriding the method 
we can intercept these changes by the layout manager and adjust our component to fit the new space. 
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% radius = min(width f height) / 2; 

Here we ignore the new location and use only the new width and hei ght. We can use them to adjust the 
radi us. Because our code can draw only a symmetric starburst, we choose the minimum of the wi dth 
and hei ght as the new diameter, setting the radi us to be one-half the diameter. The method mi n () was 
statically imported from j ava. 1 ang. Math. 

# super.setBounds(x, y, width, height); 

The JComponent from which our class is derived must also know about the size and position of the com¬ 
ponent from the layout manager. Once we have obtained the information we need, we pass the informa¬ 
tion along to the version of setBoundsO in the parent class, which is JComponent in thi s example. We 
do so by using the keyword super, which we discussed in Section 7.1, A Student “Is a”Person, on page 
195. 



repaint(); 


Once the component has been resized, we need to request that it be repainted as soon as possible. This 
call to repai nt() results in an eventual call to the method pai ntComponent ()■ 
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9.3 PROBLEM SOLVING: PLOTTING DATA 


An important application of computers is the visualization of data. A common visualization of data is a plot 
or graph of a function. Let’s say that we want to create a component that can be used to plot an arbitrary 
function of one variable. We also want to be able to add the component to a GUI as we would any other com¬ 
ponent. The following is a complete specification of the problem. 

Plotting Data 

1. The plot component must be able to plot any function of one variable. 

2. The plot component will be given a range of values over which to plot the function, (e.g. plot the 
value of the function between 0 and 100). 

3. The plot component will have a default size and will adjust the scaling of the plot so that it just 
fills the allotted screen space. 

4. When resized, the plot component will readjust its scaling values so that the plot continues to 
just fill the allotted screen space. 

In Section 9.2, Getting a Component to Resize , on page 261, we showed how to get a component to adjust its 
size when we resize the window. We can apply that same tec hni que here. The main difference is that before 
we knew exactly what we were going to draw. For this problem, the component needs to use another object 
to figure out what to draw. The question we have to answer is: How do we represent a function so that differ¬ 
ent functions can be specified without changing the plot component? 

The answer is to use an interface. (We discussed interfaces in Section 7.8, Interfaces , on page 214. If you 
skipped it earlier, this would be a good time to go back and read that material.) We can create an interface 
that describes an arbitrary function in a way that’s useful for our plot component. All the plot component 
needs is the ability to evaluate the function at an arbitrary point. Therefore the following interface will suf- 
fice. 

//Function.java 
interface Function { 

public double valueAt(double x); 

} 
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This interface simply specifies that any class implementing it must have a method val ueAtQ, which is to be 
used to determine the value of the function at the specified point. 

The class Plot is similar to the class Star2 discussed earlier. It extends ^Component and contains the same 
methods —pai ntComponent (), setBounds(), getMi nimumSi ze(), and getPreferredSi ze()— although the 
bodies of the methods are different. It also has two helper methods that are used to handle the scaling and 
positioning of the plot. 


//Plot.java 

import java.awt.*; 

import javax.swing.*; 

import static java.lang.Math.*; 


public class Plot extends JComponent { 


public Plot(Function f, double start, double end, double deltaX) { 
function = f; 
delta = deltaX; 
from = start; 
to = end; 

findRangeQ; // find max and min of f(x) 

setSize(200, 100); // default width, height 


public void paintComponentCGraphics g) { 
double x = from; 

double f__of__x = function, valueAt(x) ; 
while (x < to - delta) { 
double f_of_x_plus_delta; 

f_of_x_plus_delta = function.valueAt(x + delta); 
drawLine(g, x, f__of_x, x + delta, f__of_x_.plus_delta); 
x = x + delta; 
f_of_x = f_of_x„plus_delta; 


drawLine(g, x, f_of_x, to, function.valueAt(to)); 


public void setBounds(int x, int y, int width, int height) { 
xScale = (width - 2) / (to - from); 
yScale = (height - 2) / (fmax - fmin); 
dim = new Dimension(width, height); 
super.setBounds(x, y, width, height); 
repaint(); 

} 


public Dimension getMinimumSize() { 
return dim; 

} 

public Dimension getPreferredSize() { 
return getMinimumSize(); 

} 

// scale and translate the points from the 

// user’s coordinate space to Java’s 

private void drawLine(Graphics g, double xl, double yl, double x2, double y2) { 
g.drawLine((int)round((xl - from) * xScale), 

(int)round((fmax - yl) * yScale), 

(int)round((x2 ~ from) * xScale), 

(int)round((fmax - y2) * yScale)); 


} 
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// determine the minimum and maximum values of 
// f(x) with x varying between from and to 
private void findRangeO { 

fmin = fmax = function.valueAt(from); 

for (double x = from + delta; x < to - delta; x = x + delta) { 
double f_of_x = function.valueAt(x); 
if (f_of_x < fmin) 
f m i n = f __o f __x; 
if (f_of_x > fmax) 
fmax = f_of__x; 

} 

} 

private Dimension dim- 
private double fmin, fmax; 
private double xScale, yScale; 
private double from, to, delta; 
private Function function; 

} 

Before presenting the dissection of the class Plot, we present a test program that uses Plot. For it we need 
two more classes. The first, SinFunction, implements the interface Function. As the name suggests, the 
values returned will correspond to sin(x). The second, PI otTest, is where mai n () is located. 

//SinFunction.j ava 

class SinFunction implements Function { 
public double valueAt(double x) { 
return Math.sin(x); 

} 

} 

//PlotTest.java 
import java.awt.*; 
import javax.swing.*; 

class PlotTest { 

public static void main(String[] args) { 

Function f = new SinFunctionQ ; 

JFrame frame = new jFrameO’PlotTest"); 

Container pane = frame.getContentPaneO ; 

Plot plot = new Plot(f, 0, 2 * Math. PI, 0.1); 

pane.add(plot); 

frame.pack(); 

frame.setVisible(true); 

} 

} 

In this code we specified that a PI ot component be created that plots the function specified by the Si nFunc¬ 
ti on object f. We further specified that the plot let x go from 0 to 2 pi, in steps of 0.1. The following screen 
shots show the output. Image (a) shows the initial display. Image (b) shows how the plot is adjusted when the 
window is resized. 
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(a) 





Dissection of the Class PI ot 


//Plot.java 

import java.awt.*; 

import javax.swing.*; 

import static java.lang.Math.*; 


public class Plot extends 
public PlotCFunction f, 
function = f; 
delta = deltaX; 
from = start; 


^Component { 

double start, double end, 


to = end; 
fi ndRangeQ ; // 
set$ize(200, 100) 


find max and min of f(x) 

// default width, height 


} 


double deltaX) { 


The class Plot needs a constructor to specify the parameters of the plot. To plot a function f(x ), we 
must know the function, the range of x, and the distance between successive x values. The constructor 
simply stores all these values in instance variables. We also set a default size. The method setSi ze() is 
inherited from the class ^Component. The call to setSi ze() eventually leads to a call to the method 
setBoundsC), which is defined in the class Plot. This procedure is different from the one in Star2, 
where we specified the initial size by setting some instance variables. The reason we need to call set¬ 
Si ze() here but didn’t in Star2 is that in Plot we need to have setBoundsO called even if the window 
isn’t resized. We set the scaling parameters in setBoundsC). 
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public void paintComponent(Graphics g) { 
double x = from; 

double f_of_x = function.valueAt(x); 
while (x < to - delta) { 
double f_of_x_plus„delta; 

f_of„x„plus_delta = function.valueAt(x-fdelta) ; 
drawLine(g, x, f_of_x, x + delta, f_of_x_plus„delta); 
x = x + delta; 
f_of_x = f_of_x_plus_delta; 

} 

drawLine(g, x, f„of„x, to, function.valueAt(to)); 


The method pai ntComponentQ plots the curve by repeatedly drawing a line from (x, f(x)) to (x + delta, 
f(x + delta)). Because delta may not evenly divide the range of x values, we make sure that the last point 
is at (to, f(to)). To avoid computing the value of the function twice at the same point, we copy 
f_of_x_.pl us_del ta into f_of_x when we increment x. The private function dr aw Li ne() converts from 
the coordinate space of the function to the coordinate space of Swing and then calls the standard 
method drawLi ne() from the class Craphi cs. 

% public void setBounds(int x, int y, int width, int height) { 
xScale = (width - 2) / (to - from); 
yScale = (height - 2) / (fmax - fmin); 
dim = new Dimension(width, height); 
super.setBounds(x, y, width, height); 
repaint(); 

. } 


As in Star2, this function is called when the layout manager places the PI ot component in its container 
or if we resize the window containing our plot, using the desktop facilities of our computer. By comput¬ 
ing the scaling and setting the Dimension variable dim inside setBoundsO, our Plot component auto¬ 
matically resizes itself. After adjusting the scale factors and changing dim, we call repai nt() to have 
the graph recomputed. In this example, we placed the Pi ot object in a J Frame with a content pane that 
uses a BorderLayout manager. The BorderLayout manager attempts to adjust the size of the Plot 
object to fill the 1 Frame. 



private void drawLine(Graphics g, double xl, double yl, double x2, double y2) { 
g.drawLine((int)round((xl - from) * xScale), 

(int)round((fmax - yl) * yScale), 

(int)round((x2 - from) * xScale), 

(int)round((fmax - y2) * yScale)); 



In Swing, positive vertical distance is down , but normal plotting uses up for positive vertical distance. In 
addition, we need to adjust the origin, and scale all values so that the graph just fills the display. We use 
round () via static import from the standard class java. lang. Math, which returns a long when passed 
a doubl e. We then cast the long to an i nt as required by method drawLi ne(). The method drawLi ne() 
in the class Graphi cs draws a line between two points. The first two parameters to drawl i ne() are the 
x and y coordinates of the first point, and the last two parameters are the coordinates of the second 
point. (See Section 9.4, The Class Graphics, on page 268 for another way to draw lines.) 
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private void findRangeC) { 

fmin = fmax = function.valueAt(from); 

for (double x = from + delta; x < to - delta; x - x + delta) { 
double f_of__x = function.valueAt(x); 
if (f__of_x < fmin) 
fmin = f_of_x; 
if (f_of_x > fmax) 
fmax = f„of_x; 

} 

} 


To calculate yScal e, we need to know the range of values for f(x) in the interval being plotted. To get it 
we simply iterate over the range of points at which the function is to be plotted and record the minimum 
and maximum values computed. 




9.4 THE CLASS Graphics 

Basic drawing in Java is done on an instance of the class Graphi cs. You can call the method getGraphi cs() 
on any component to get the Graphi cs object for that component. However, you should normally do your 
drawing within the method pai ntComponent (). Any drawing on the Graphi cs object done outside the 
method pai ntComponent () is replaced by the actions of pai ntComponent () the next time the window man¬ 
ager senses that the window needs updating. 

We have used several drawing primitives in the examples so far. We used drawLi ne() to draw the lines of 
the starburst in Star. We used f i 1 1 Oval () to draw the small filled circles for our brush strokes in Drawi ng- 
Canvas. In addition, the class Graphi cs includes methods for drawing filled and unfilled rectangles, unfilled 
ovals, filled and unfilled polygons, and text strings. For the unfilled shapes the outline of the shape is always 
drawn with a 1 pixel-wide line. 

The following program demonstrates a sampling of some basic drawing methods. Due to the length of the 
program it is presented only in dissected form. 




Dissection of the class GraphicsSampler 


# //GraphicsSampler.java 
import java.awt.*; 
import javax.swing.*; 

class CraphicsSampler extends 3Component{ 
public static void main(String[] args) { 

IFrame frame = new JFrame("GraphicsSampler"); 

Container pane = frame.getContentPaneO; 
pane.addfnew Graphi csSamplerO); 
frame.pack(); 
frame.setVisible(true); 

} 

For this example we have included the simple main Q in the same class as the component that will do 
the drawing. This is a common idiom for adding a small test main to a class being developed. 
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# public void paintComponent(Graphics g) { 

// draw some simple lines 
g.drawLine(10, 10, 100, 60); 
g.drawLine(100, 60, 50, 80); 
g.drawLine(50, 80, 10, 10); 

The pai ntComponent () method in this example contains a sequence of drawing commands. The sim¬ 
plest tiling you can draw is a line; you merely specify the coordinates of the two ends of the line. The 
method d rawLi ne () takes four parameters: the x and y coordinates of the first point and the x and y 
coordinates of the second point, in that order. The unit of measure is the pixel, the origin is in the upper 
left comer, and positive displacements are down and to the right. You can change the color of the line 
but not its width or style (e.g., dashed). All lines are 1 pixel thick. To draw thicker lines or dashed lines 
you need to use the enhanced capabilities of the class java. awt,Graphi cs2D, which we discuss later. 

# // draw a multi-segment line with one operation 
int[] x - {120, 140, 160, 180, 200}; 

int[] y = {10, 80, 10, 80, 10}; 
g.drawPolyline(x, y, x.length); 

The method drawPolyl i ne() takes three parameters: an i nt array for the x coordinates, an i nt array 
for the y coordinates, and the number of points to draw. The number of points must be less than or 
equal to the length of the shorter of the two arrays. 

$ int yOrigin = 100; 

// draw two types of rectangles 
g.drawRect(0, yOrigin, 100, 60); 

Here we introduce the yOri gi n variable that we will use to keep track of vertical displacement as we 
draw more shapes. You can draw rectangles by using either fi 11 Rect(), for filled rectangles, or 
drawRect (), or outlined rectangles. As discussed in Section 8.5, Drawing with Swing , on page 237, you 
specify the four values left , top , width , and height to place and size the rectangle. 

# g.drawRoundRect(110, yOrigin, 100, 60, 40, 20); 
g.setColor(Color.gray); 

g.drawOval(170, yOrigin+40, 40, 20); 

You can also draw rectangles with rounded comers by using drawRoundRectQ and fil IRoundRectQ. 
In addition to the four values for regular rectangles, you must also specify the width and height of the 
arcs placed at the comers. In this example we included a gray oval with width 40 and height 20 superim¬ 
posed over one of the comers to show how the arc width of 40 and height of 20 are used to round the 
comer. We discuss changing the color later in this section. 

| yOrigin = yOrigin + 100; 

// draw an oval in a rectangle 
g.drawRect(10, yOrigin+10, 100, 60); 
g.drawOval(10, yOrigin+10, 100, 60); 

Ovals are drawn very much like rectangles. You specify a rectangle, and the largest oval that will fit 
inside the rectangle is drawn. There are just two methods: drawOval () and fi 11 Oval (). This example 
shows how an oval is drawn inside a rectangle. 
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H yOrigin = yOrigin + 100; 

// draw two types of arcs 

g.drawArc(0, yOrigin, 100, 60, 0, 160); 

g.fillArc(110, yOrigin, 60, 60, 45, -135); 

Arcs are Incomplete ovals. As with an oval, you specify a bounding rectangle. In addition, you specify the 
starting angle and the arc angle, giving both angles in Integer degrees. A starting angle of 0° corresponds 
to 3 o’clock, and positive angles correspond to counter clockwise rotation. Arcs can be filled or drawn in 
outline. 


In this example we draw an unfilled arc starting at 0° (3 o’clock) and then sweeping counterclockwise for 
160°. We then draw a filled arc starting at 45° and then sweeping 135° clockwise to finish at 6 o’clock. 



yOrigin = yOrigin + 100; 

// draw some polygons 
Polygon p = new PolygonQ; 
p.addPoint(10, yOrigin+10); 
p.addPoint(60, 
p,addPoint(40, 
p.addPoint(25, 


yOrigin+30); 
yOrigin+50); 
yOrigin+40); 


g.drawPolygon(p); // draw a Polygon object 


You draw a polygon by first creating a java. awt. Pol ygon object. You then add points to the polygon 
one at a time with the method addPoi nt (), each of which specifies the coordinates of a vertex. 

# // draw a polygon using 2 arrays 

int[] xValues = {110, 160, 140, 125}; 

int[] yValues = {yOrigin+10, yOrigin+30, yOrigin+50, yOrigin+40}; 
g.f i 11 Polygon(xValues, yValues, xValues.1ength); 

//move 200 pixels right and 20 down 
p.translate(200, 20); 

g.drawPolygon(p); // draw translated polygon 


You can also draw a polygon by using two integer arrays: one for the x coordinates of the vertices and 
one for the y coordinates of the vertices. A polygon can be filled or drawn in outline. The class Polygon 
also has a method transl ate -) that you can use to translate all the points vertically and horizontally. 

® yOrigin = yOrigin + 100; 

// draw some text with marker boxes to show orientation 
int yCoord = yOrigin +20; 

g.drawString("Starts at (10, "+ yCoord + ")”, 10, yCoord); 
g.fillRect(10, yCoord, 4, 4); 


You can use labels and text areas to place text in a GUI. Sometimes you may want or need to add text to a 
component that you’re drawing on. In that event you can use the method drawStri ng() from the class 
Graphi cs. It takes three arguments: the strrng and the two coordinates of the starting point. You can 
also change the font. In this example we added small filled rectangles at the coordinates of the starting 
points for the drawStri ng () calls. Note how the position of the text relates to the starting point. 

• g.setFont(new FontC’TimesRoman", Font.BOLD, 20)); 

yCoord = yOrigin +40; 

g.drawString("20pt bold starting at (100, " + yCoord + ")", 

100, yCoord); 

g.fillRect(100, yCoord, 4, 4); 


} 

The call to setFont () needs a j ava. awt. Font object, which we obtain by constructing a new font. We 
specify the name of the font as a string, a parameter used to modify the font (making it bo d in this 
case), and the size of the font in points. Points are a unit of measure originally used by typesetters (72 
points/inch). The normal text in this book is 10 points. 
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public Dimension getMinimumSizeO { 
return dim; 

} 


} 


public Dimension getPreferredSize() { 
return dim; 

} 

private Dimension dim = new Dimension(420, 600); 


As in previous examples, these methods and this definition of di m make the component have the desired 
dimensions on the screen. 
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You can easily change the color of the objects drawn by any of the methods discussed. To do so, call set- 
Color() for the Graphi cs object before calling the drawing method. You can use the standard class 
java. awt. Color to create almost any color. You can create your own color by specifying the amounts of red, 
green, and blue needed to form the color. You do so in the constructor for Color, passing it three integers, 
each in the range 0 to 255, inclusive. These are the red, green, and blue intensities, respectively, also called 
the RGB values. For any Color object you can also call the methods bri ghter() or darker () to return a new 
color that is brighter or darker than the original color. 

The class Color also includes some predefined colors that you can use by name—for example, Color, red, 
Color .green, Color . whi te, and Color, bl ack. Each of these predefined colors is declared to be a 
public static final Color value. 


Common Programming Error 


A common syntax error involves incorrectly typing the color constant names. For example, Color .Green 
is an undeclared identifier, but it is hard to find because it seems right. Recall that all identifiers in Java 
are case sensitive. The identifier Color.purple is incorrect because not all common color names are 
predefined. 


When defining your own color, be sure that the values are appropriate. For example, 


g.setColor(new Color(260, 10, 38)); 

leads to an Illegal ArgumentsException because the value 260 is out of range. When you’re mixing 
colors the range for the three arguments is from 0 to 255, inclusive. Also, don’t use anonymous RGB val¬ 
ues. A better definition would be 

Color lightOrange = new Color(255, 190, 0); 
g.setColor(lightOrange); 

Here the intent is clear, making the code easier to understand and maintain. 


The output from Graphi csSampler is on the next page. 
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9.5 CHANGING THE STROKE USED IN DRAWING 


The class java.awt .Graphics2D, which extends Graph ics, adds many sophisticated drawing operations to 
Java. One example is the ability to control the brush stroke used in drawing lines and shapes. The parameters 
of a brush stroke that we can control are 

# the width of the brush, 

# the dash pattern of the brush, 

# the shape of the end of a brush stroke, 
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# what happens when two ends join, and 

# for dashed lines, where In the dash pattern does the stroke begin. 

The following program is a brief introduction to creating and setting the stroke used in drawing operations. 

//StrokeSampler.java - examples of some Java2D strokes 
import java.awt.*; 
import javax.swing.*; 

class StrokeSampler extends JComponent { 
public void paintComponent(Graphics g) { 

Graphics2D g2d = (Graphics2D)g; 

// draw some rectangles with wide lines 

g2d.setStroke(wideStroke); 

g2d.drawRect(10, 10, 100, 60); 

g2d.setStroke(mediumStroke); 

g2d.drawRoundRect(120, 10, 100, 60, 40, 20); 

// draw some lines with round ends/joints 
int[] xcoords = {30, 60, 90}; 
int[] ycoords = {90, 140, 90}; 
g2d.setStroke(wideRound); 
g2d.drawPolyline(xcoords, ycoords, 3); 

// draw some lines with bevel joints 
for (int i = 0; i < xcoords.1ength; i++) 
xcoords[i] = xcoords[i] + 110; 
g2d.setStroke(wideBevel); 
g2d.drawPolyline(xcoords, ycoords, 3); 

// use a dot-dash stroke 

g2d,setStroke(dotDashStroke); 

g2d.drawRect(10, 170, 100, 60); 

g2d.drawRoundRect(120, 170, 100, 60, 40, 20); 

} 

static final BasicStroke wideStroke = new BasicStroke(8.0f); 
static final BasicStroke mediumStroke = new BasicStroke(4.0f); 
static final BasicStroke wideRound = new BasicStroke(16.0f, 

BasicStroke.CAP„ROUND /* end style */, 

BasicStroke.30IN„R0UND /* join style */); 

static final BasicStroke wideBevel = new BasicStroke(16.0f, 

BasicStroke.CAP_BUTT /* end style */, 

BasicStroke.JOIN_BEVEL /* join style */); 
static floatf] dotDash = {10.0f, 5.0f, 5.0f, 5.0f}; 

static final BasicStroke dotDashStroke = new BasicStroke(4.0f /*width*/» 

BasicStroke.CAP_BUTT /*end style*/, 

BasicStroke.JOIN_MITER /*join style*/, 

1.0f /*miter trim limit */, 
dotDash /* pattern array */, 

0.0f /* offset to start of pattern */); 

public Dimension getMinimumSizeQ { 
return new Dimension(230, 240); 


} 
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public Dimension getPreferredSize() { 
return getMinimumSizeO ; 

} 


When added as the only component in a 3 Frame, the class StrokeSampl er generates the following display. 
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StrokeTest 




Dissection of the Class StrokeSampl er 


• import java.awt.*; 
import javax.swing.*; 

class StrokeSampler extends JComponent { 
public void paintComponent(Graphics g) { 

Graphics2D g2d = (Craphics2D)g; 

This sample class extends ^Component, as in other examples. Here we cast the Graphics object to a 
Graphi cs2D object. The class Graphi cs2D extends the class Graphi cs, so we can still do anything we 
could do before with Graphi cs. The method pai ntComponent () is designed to take a parameter of type 
Graphi cs instead of type Graphi cs2D for compatibility and historical reasons. 

• g2d.setStroke(wideStroke); 
g2d.drawRect(10, 10, 100, 60); 
g2d.setStroke(mediumStroke); 

g2d.drawRoundRect(120, 10, 100, 60, 40, 20); 

Here we draw rectangles as before, but we first set the stroke that is to be used. Once set, a stroke con¬ 
tinues to be used until changed again. 

• // draw some lines with round ends/joints 
int[] xcoords - {30, 60, 90}; 

int[] ycoords = {90, 140, 90}; 
g2d.setStroke(wideRound); 
g2d.drawPolyline(xcoords, ycoords, 3); 

// draw some lines with bevel joints 
for (int i = 0; i < xcoords.length; i++) 
xcoords[i] = xcoords [i] + 110; 
g2d.setStroke(wideBevel); 
g2d.drawPolyline(xcoords, ycoords, 3); 

Here we draw two multisegment lines. Each polyline consists of two line segments, forming a V. These 
statements are used to demonstrate how a stroke can be defined to have different end and join shapes. 
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9.6 


• g2d 
g2d 
g2d 


setStroke(dotDashStroke); 
d rawRect(10, 170, 100, 60); 
drawRoundRect(120, 170, 100, 60, 40, 20); 


The final two drawing calls in this class draw two rectangles, using a dot-dash pattern. We describe 
shortly the stroke dotDashStroke. 

static final BasicStroke wideStroke = new BasicStroke(8.0f); 
static final BasicStroke mediumStroke = new BasicStroke(4.0f); 


single parameter for the Basi cStroke constructor used here is the width of the stroke. The value is 
floating point value. Again, the units are in pixels. 


static final BasicStroke wideRound = new BasicStroke(16 

BasicStroke.CAP_ROUND /* end style */, 

BasicStroke.JOIN__ROUND /* join style */); 


0f, 


Here we construct a Basi cStroke, specifying the width and style to be used where the ends of two line 
segments join. The result—previously shown in the output of the program—is that the ends of the line 
are rounded and that the comer where the two line segments join is also rounded. 

H static final BasicStroke wideBevel = new BasicStroke(16.0f, 

BasicStroke.CAP_BUTT /* end style */, 

BasicStroke.JOIN_BEVEL /* join style */); 

For contrast, here we constmct a Basi cStroke that uses different end and join styles. The difference, as 
shown in the output of the program, is obvious. 


static 
static 


float[] dotDash - {10.0f, 5.0f, 5.0f, 5.0f}; 

final BasicStroke dotDashStroke = new BasicStroke(4.0f /*width*/> 

BasicStroke.CAP_BUTT /*end style*/, 

BasicStroke.JOIN^MITER /*join style*/, 

1.0f /*miter trim limit */, 
dotDash /* pattern array */, 

0.0f /* offset to start of pattern */); 

Here we constmct a Basi cStroke, specifying a dash pattern by an array of f 1 oat values. The line is 
drawn by alternating marks and spaces. The length of the first mark is specified by dotDash [0]. The 
length of the first space is specified by dotDash [1], the length of the second mark is specified by dot¬ 
Dash [2], and so on. When the end of the array is reached, the pattern goes back to the be ginnin g. The 
array dotDash specifies a pattern that is a 10-pixel line, a 5-pixel space, a 5-pixel line, a 5-pixel space, a 
10-pixel line, and so on. The miter trim limit isn’t directly related to the dash pattern, but we must spec¬ 
ify it when specifying a pattern. The miter limit controls how much a bevel join can extend to make a 
clean bevel. We left it at the minimum legal value, which is 1. The last parameter can be used to control 
starting the stroke somewhere other than at the beginning of the pattern. For example, if we had speci¬ 
fied the offset to be 15.0f instead, the stroke would begin with a short, 5-pixel mark because that is 15 
pixels into the pattern. 
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ADDING MENUS TO A GU 


A standard feature on most GUI-based programs today is a menu. In this section we present a brief introduc¬ 
tion to the support in java for menus. We do so by adding a menu to the Si mpl ePai nt2 program discussed 
in Section 8.7, A Simple Drawing Program , on page 244. We could add many features via a menu, but here we 
add only two menus. The first is the standard Fi ! e menu found in most programs today. In the Fi 1 e menu 
we add only a single item, Exi t. The second menu is Opti ons. Here we add the ability to change the diameter 
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of the virtual pen tip used to do the drawing. This addition appears in the following screen shot, where we 
have just selected the large pen size option. 
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SimplePaintMenu 


The program consists of five classes and one interface. The method mai n () is in Si mpl ePai ntMenu. The 
class Pai ntLi stener3 extends Pai ntLi stener2, adding a method used to set the pen size. The interface 
Pai riter is used to isolate the mouse motion listener, Pai ntListener3, which does the painting, from the 
action event listener, PenAdjuster, which responds to the menu selections. The program also uses 
Drawi ngCanvas2 from Section 8.7, A Simple Drawing Program , on page 244 with no changes. The relation¬ 
ship between these five new classes and some of the standard Java classes used by this program can be visu¬ 
alized in the following UML diagram. 
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The following code lacks only Drawi ngCanvas2 and Pai ntLi stener2. 

// SimplePaintMenu.java - add a menu to SimplePaint2 
import java.awt.*; 
import javax.swing.*; 

class SimplePaintMenu { 

public static void main(String[] args) { 

JFrame frame = new JFrameC'SimplePaintMenu"); 
Container pane = frame,getContentPaneQ ; 

// create the canvas and mouse listener 
// just as in SimplePaint2 

DrawingCanvas2 canvas = new DrawingCanvas2(); 

PaintListener3 painter = new PaintListener3(); 
canvas.addMouseMotionListener(painter); 
pane.add(canvas); 
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// create the menu bar and top level menus 
JMenuBar menuBar = new JMenuBarO; 

JMenu fileMenu = new JMenu("File"); 
fi1eMenu.setMnemonic( 1 F'); 

JMenu optionsMenu = new JMenu("Options"); 
optionsMenu.setMnemonic('O'); 
menuBar.add(fileMenu); 
menuBar.add(optionsMenu); 
frame.setJMenuBar(menuBar); 

// add items to the fileMenu 

JMenuItem exit = new JMenuItemC'Exit",'x 1 ); 

fi1eMenu.add(exit); 

exi t. addActionLi stener(new GoodByeQ) ; 

// create and add items to the optionsMenu 
// the first item is a submenu for pen size 
JMenu penAdjusterMenu = new JMenu(”Pen size"); 
penAdjusterMenu.setMnemonic(’P') ; 

// create and add items to the pen size sub menu 
JMenuItem small Pen = new JMenuItem("Small", 'S’); 

JMenuItem mediumPen = new JMenuItem("Mediurn",'M'); 

JMenuItem largePen = new JMenuItem("Large", 'L'); 
penAdjusterMenu.add(smal1 Pen); 
penAdjusterMenu.add(mediumPen); 
penAdiusterMenu.add(largePen); 

// add a listener to the pen selection items 
PenAdjuster penAdjuster = new PenAdjuster(painter); 
smal1 Pen.addActionListener(penAdjuster); 
mediumPen.addActionListener(penAdjuster); 
largePen.addActionListener(penAdjuster); 
optionsMenu.add(penAdjusterMenu); 

// for demo purposes add second (unused) item 
optionsMenu.add(new JMenuItem("Other", '0')); 
frame.pack(); 
frame.setVisible(true); 

} 

} 

// PenAdjuster.java - pass pen adjustment requests to the painter 
import java.awt.event.*; 

class PenAdjuster implements ActionListener { 
private Painter painter; 

PenAdjuster(Painter thePainter) { 
painter = thePainter; 

} 

public void actionPerformed(ActionEvent e) { 
pai nter. setPenSi ze(e. getActionCommandQ) ; 

} 


// PaintListener3.java - paints on an DrawingCanvas2, 

// and it's associated offscreen image. 

// Adds a setPenSize() method to PaintListener2. 

public class PaintListener3 extends PaintListener2 implements Painter { 
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// specify one of three pen sizes, Small, Medium, or Large 
// radius and diameter are inherited 
public void setPenSize(String size) { 

if (size-equalsCSman")) { 

radius = 0; 
diameter = 1; 

} 

else if (size.equals("Mediurn")) { 
radius = 3; 

diameter = radius * 2; 

} 

else if (size.equals(”Large")) { 
radius = 6; 

diameter = radius * 2; 

} 

} 


// Painter.java - 

// in practice this interface would contain additional methods 
// such as for changing pen shape, color, pattern etc. 
interface Painter { 

public void setPenSize(String size); 

} 
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Dissection of the Class SimplePaintMenu 

H // SimplePaintMenu.java - add a menu to SimplePaint2 
import java.awt.*; 

PaintLi«stener3 painter = new PaintListener3() ; 
canvas.addMouseMotionListene r(painter); 
pane.add(canvas); 

The first part of this class is the same as SimplePai nt2, with the exception of the name change to 
Pai ntLi stener3. 

JMenuBar menuBar = new 3MenuBar(); 

JMenu fileMenu = new JMenu("File"); 
fileMenu.setMnemonicC F 1 ) ; 

JMenu optionsMenu = new 3Menu( M 0ptions"); 

optionsMenu.setMnemonic(’O 1 ); 

menuBar.add(fileMenu); 

menuBar.add(optionsMenu); 

frame.setJMenuBar(menuBar); 

To create a menu, we first create a javax. swi ng .JMenuBar, which is a type of container. We can then 
add javax. swi ng. JMenu objects to the JMenuBar. Finally we add the JMenuBar to the J Frame, using the 
special method setJ MenuBar(). When we create menus, we give them names. In addition, in this exam¬ 
ple we show how to create easily a keyboard shortcut by using the method setMnemoni c() for JMenu. 
As the screen shot at the beginning of this section shows, the letter passed to he method set Mne¬ 
monic () is underlined in the menu as a reminder to the user. Using the default key-bindings, the menus 
can be activated by hitting Alt and the selected key at the same time. For example, Alt+O will cause the 
Options menu to be displayed. 
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m JMenuItem exit = new JMenuItem("Exit", ’x‘); 
fi1eMenu.add(exit); 

exit.addActionListener(new GoodByeO) ; 

Here we add a JMenuItem to one of the existing menus. The constructor for JMenuItem allows us to 
specify both the name to be displayed as the menu item and the mnemonic key. A JMenuItem is a special 
kind of button. Like JButton that we used in the previous chapter, we add an Acti onLi stener to the 
menu item in order actually to do something when we select the menu item. Here we just use the class 
GoodBye from Section 8.2, Listening to Events, on page 231. When invoked, the method actionPer- 
formedQ in GoodBye forces the program to exit by using System, exi t(). 

|| JMenu penAdjusterMenu = new 3Menu("Pen size”); 
penAdjusterMenu.setMnemonic('P'); 

// create and add items to the pen size submenu 
JMenuItem smallPen = new 3MenuItem("Smal1",'S r ); 

JMenuItem mediumPen = new JMenuItem( n Mediurn",'M'); 

. JMenuItem 1argePen = new JMenuItem("Large M ,'L f ); 
penAdjusterMenu.add(smal 1 Pen); 
penAdjusterMenu.add(medi umPen); 
penAdjusterMenu.add(! argePen); 

A JMenu can contain both JMenuItems and other JMenus, which is how we obtain cascading menus. The 
Options menu eventually contains two items. The first is the Pen si ze submenu created here. The sec¬ 
ond, discussed later, is just a dummy item, Other, that is used to show that the menu could contain 
additional items. The penAdjusterMenu contains three items. We create and add these items to the 
menu as we did previously for the Exi t item in the Fi 1 e menu. 

H PenAdjuster penAdjuster = new PenAdjuster(painter); 
smal1 Pen.addActionListener(penAdjuster); 
mediumPen.addActionListener(penAdjuster); 

1argePen.addActionListener(penAdjuster); 

We dissect the class PenAdjuster shortly. It implements ActionLi stener. We use one instance of Pen¬ 
Ad j uster to listen to all three pen adjustment menu items. 

• opti onsMenu.add(penAdjusterMenu); 

// for demo purposes add second (unused) item 
optionsMenu.add(new JMenuItem( n Other”, '0')); 

Here we add the penAdjusterMenu to the top-level opti onsMenu. We then add a second dummy menu 
item that doesn’t do anything. Thus we can mix submenus and regular menu items in a single menu. 

• frame.pack(); 

frame.setVisible(true); 

As always, the method mai n() ends by calling these two methods. 
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Dissection of the Class PaintListener3 


# import java.awt.*; 

import java.awt.event.*; 

public class PaintListener3 extends PaintListener2 implements Painter { 

The only change from PainterListener2 is the addition of a method that can be used by some other 
class to change the pen size used by Pai ntListener3 when it draws in response to mouse motion 
events. We could have just copied PainterListener2 and modified it. Instead, we used the inheritance 
mechanism in Java to extend Pai ntLi stener2. In this way, any improvements or corrections we make 
to the class Pai ntLi stener2 will automatically be incorporated in the class Pai ntLi stener3. The inter¬ 
face Painter specifies that the class Pai ntLi stener3 contains a method setPenSi ze(). We discuss 
Pai nter further shortly. 

H public void setPenSize(String size) { 
if (size.equals("Small")) { 
radius = 0; 
diameter = 1; 

} 

else if (size.equals("Medium")) { 
radius =3; 

diameter = radius * 2; 

} 

else if (size.equals("Large")) { 
radius = 6; 

diameter = radius * 2; 

} 

} 

The method setPenSi ze() expects to be passed one of three strings. If one of the expected strings is 
passed, the radi us and di ameter of the pen are adjusted appropriately. If the parameter doesn’t match 
any of the strings, the pen size is left unchanged. The instance variables radi us and diameter were 
declared to be protected in Pai ntLi stener2. That allows us to modify and use them from a derived 
class such as Pai ntLi stener3. Recall that radi us and di ameter are used to specify the shape to be 
drawn. The following statement from Pai ntLi stener2 does the actual drawing. 

g.fillOval (e.getXQ - radius, e.getYQ - radius, diameter, diameter); 
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Dissection of the Classes PenAdjuster and Painter 


# import java.awt.event;*; 

class PenAdjuster implements ActionListener { 
private Painter painter; 

PenAdjuster(Painter thePainter) { 
painter = thePainter; 

'' 1 > ' "■ 

A PenAdjuster object acts like an intermediary between a menu item that it is listening to and a 
Pai nter object that can have its pen size adjusted. The PenAdjuster must be passed a reference to the 
Pai nter when it is created. The menu item knows about the PenAdjuster when the PenAdjuster is 
added to the menu item as an action listener. 

H public void actionPerformed(ActionEvent e) { 
painter.setPenSize(e.getActionCommand()); 

} 

One instance of PenAdjuster is created, and that object is added as an action listener to each of the pen 
adjustment menu items, Small, Medium, and Large. When the method actionPerformedO is called, 
the PenAd j uster passes the string it gets from the menu item to the Pai nter associated with this Pen- 
Adjuster. As with JButton objects, the default action co mm and string for a JMenuItem is the same as 
the string used to label the JMenuItern. All that PenAd j uster has to do is pass the string to the method 
setPenSi ze() of the Pai nter. As we showed earlier, the Pai nter object will examine the string and 
possibly change the pen size. 

% interface Painter { 

public void setPen$ize(String size); 

} 

We didn’t really need the interface Pai nter. We could have defined PenAd j uster to contain a reference 
to a Pai ntLi stener3 instead of a Pai nter. However, the class PenAdjuster doesn’t need to know that 
Pai ntLi stener3 has methods for mouse motion events. Furthermore, we can reuse Pai nter and Pen- 
Adjuster in other programs, or we can decide to change the name of Pai ntLi stener3. In either case, 
we wouldn’t need to make any changes to Pai nter or PenAdjuster. 
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9.7 EVENT LISTENERS AND ADAPTERS 


In Section Section 8.2, Listening to Events , on page 229 we introduced the concept of event listeners. Recall 
that they are used to respond to events generated from a specific event source, such as a JButton, and that 
the various event listener types are specified by interfaces. As we discussed in Section 7.8, Interfaces , on page 
214, an interface specifies the methods that a class must implement without providing any method imple¬ 
mentations. For this reason, one class can implement multiple interfaces. To do so, however, the class must 
include the union of all methods in the interfaces. 

In the following program we show how a single class can handle all the events for a program. The event han¬ 
dler class, GameEventHandler, handles action events from a Quit JButton and mouse clicks in a JCompo- 
nent. The JComponent is intended to represent a generic game board as might be used with the Predator- 
Prey simulation in Section 7.7, An Example: Predator-Prey Simulation , on page 207. Mouse clicks on the 
JComponent are used to change the states of the cells. The entire program consists of three classes. Game- 
Test contains mai n (). Its contents should be rather familiar to you by this time, so we won’t discuss it fur- 
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ther. GameBoard extends ^Component and has much in common with Plot, which we discussed in Section 
9.3, Problem Solving: Plotting Data, on page 263. The listeners are implemented in GameEventHandler. 

//GameTest.java 
i mpo rt j ava. avvt. *; 

class GameTest { 

public static void main(String[] args) 

{ 

GameBoard.State[][] state = new GameBoard.State[20][20]; 
for (int row = 0; row < state.length; row++) { 

for (int col = 0; col < state[row].length; col-H-) { 
state[row][col] = GameBoard.State.state©; 

} 

} 

DFrame frame = new JFrame("GameTest"); 

Container pane = frame.getContentPaneQ; 

GameBoard board = new GameBoard(400, 400, state); 

GameEventHandler actor = new GameEventHandler(); 

board.addMouseListener(actor); 

pane.add(board, BorderLayout.CENTER); 

JButton quit = new JButton("Quit"); 
quit.addActionListener(actor); 
pane.add(quit, BorderLayout.NORTH); 
frame.pack(); 
frame.setVisible(true); 

} 

} 

//GameBoard.j ava 
import java.awt.*; 
import javax.swing.*; 

class GameBoard extends ^Component { 

// the example supports only two valid states 
static enum State { state0, statel } 

public GameBoard(int width, int height, State[j[] board) { 
this.board = board; 

setSize(new Dimension(width, height)); 

} 

// draw the cells of the board 
protected void paintComponent(Graphics g) { 
for (int row = 0; rowcboard.length; row++) 

for (int col=0; col < board[row].length; col++){ 
select__color(g, board [row] [col]) ; 

g.fi11Rect(col * cellWidth, row * cellHeight, cellWidth, cellHeight); 

} 

} 

/* The default updateO redraws the entire display using the background 

* color, then calls paint(). To avoid the flicker of background color, 

* we override updateO to just call paint(). 

* This is recommended whenever paintComponent() redraws all pixels. 

*/ 

public void update(Graphics g) { 
paintComponent(g); 

} 
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public Dimension getMinimumSizeQ { 
return dim; 

} 

public Dimension getPreferredSize() { 
return getMinimumSizeO; 

} 

public void setBounds(int x, int y, int width, int height) { 
dim = new Dimension(width, height); 

//adjust cell size to fill the new board size 
cellWidth = Math.round((float)width / board.1ength); 
cellHeight = Math.round((float)height / board[0].length); 
super.setBounds(x, y, width, height); 
repaint(); 

} 

public void setCell(int row, int col, State value) { 
board[row][col] = value; 

} 

public State getCell(int row, int col) { 
return board[row][col]; 

} 

public int getCellWidth() { return cellWidth; } 

public int getCellHeightC) { return cellHeight; } 

private void select_color(Graphics g, State cell) { 
if (cell == State.stateO) 
g.setColor(Color.white); 
el se 

g.setCol or(Col or.black); 

} 

private State[][] board; 

private int cellWidth, cellHeight; 

private Dimension dim; 


// GameEventHandler.java 
import java.awt.event.*; 

class GameEventHandler implements MouseListener,ActionListener { 
public void actionPerformed(ActionEvent e) { 

System.out.println("Goodbye!"); 

System.exit(0); 


public void mousedicked(MouseEvent e) { 

GameBoard board = (GameBoard)e.getSourceQ; 
int row = e.getYQ / board.getCellHeightC); 
int col = e.getXO / board.getCellWidth() ; 
if (board.getCel1(row, col) == GameBoard.State.state0) 
board.setCel1( row, col, GameBoard.State.statel); 
el se 

board.setCell ( row, col, GameBoard.State.state0); 
board. repaintQ; 
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public void mouseEntered(MouseEvent e) {}; 
public void mouseExited(MouseEvent e) {}; 
public void mousePressed(MouseEvent e) {}; 
public void mouseReleased(MouseEvent e) {}; 

} 

Here is what the display looks like after we chck five different places on the screen. 





Dissection of the Class CameEventHandler 


# class GameEventHandler implements MouseListener,ActionListener { 

For this program we’re interested in mouse chck events, which requires us to implement the interface 
MouseLi stener. We also use this same event handler to respond to clicks on a “Quit” button so we also 
implement the interface Actionli stener. 

• public void actionPerformed(ActionEvent e) { 

System.out.println("Goodbye!"); 

System. exi t(0); 

} 

This is the same method we used earlier in tne class CoodBye from Section 8.2, Listening to Events , on 
page 231. 
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• public void mousedicked(MouseEvent e) { 

CameBoard board = (GameBoard)e.getSourceO; 
int row = e.getYO / board.getCellHeightO ; 
int col = e.getXO / board.getCellWidthQ; 
if (board.getCel1(row, col) == GameBoard.State.state0) 
board.setCell( row, col, GameBoard.State.statel); 
else 

board.setCel1( row, col, GameBoard.State.stateO); 
board. repaintO; 

} 

This method is one of the five specified in the MouseListener interface. It is the only one we actually 
care about. From the event e we can obtain the GameBoard object and the coordinates of the cursor at 
the time the mouse button was clicked. We use them to select one cell in our GameBoard and then toggle 
the state in the selected cell. To have the change be reflected immediately on the screen, we call 
repaintO. If this listener was listening to more than one MouseEvent source, we could use the 
instanceof operator to determine whether it was indeed a GameBoard before doing the cast. 

$ public void mouseEntered(MouseEvent e) {}; 
public void mouseExited(MouseEvent e) {}; 
public void mousePressed(MouseEvent e) {}; 
public void mouseReleased(MouseEvent e) {}; 

} 

These are the other four methods required of any class that implements the interface MouseLi stener. 
We aren’t interested in any of these events, so the methods do nothing. See the following discussion of 
adapter classes for a way to avoid including these empty method definitions. 



We don’t have sufficient space in this book to cover all the AWT listener classes. To help you handle specific 
events, we included the following table of the AWT listener classes. The table lists the methods specified in 
each interface and some of the classes of objects that can generate the events for the particular listener. 
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Class derived from 
E ventListener... 

: ■; ! : i i: ::V \ : r :! -i: : :: . , x :‘ '&!! kk ? •: x : . 

•:;■:: x :’x :;xx xxXy: •.. . : x : :. ; y;.;X: : yyxyx : X;y; ;y : ", . 

; :: x y . x x; xx • y-xx: yy: -:::: x-x : y :::::: : : :x: r : : . 

METHODS . . . 

’ : y 1 • • •. •••••••••• -.■ ■ ■ * * • ■ 


CAN BE ADDED TO ANY . . . 

■,:-y; y-:, ■■yy-vy^;:;.- 
:; 

111 i 

ActionListener ! 

actionPerformed() 

JButton, JList,JTextField, JMenuItem 

AdjustmentListener 

adjustmentVal- 
ueChangedQ 

JScrol1 Bar 

ComponentListener 

componentHidden(), 
componentMoved(), 
componentResizedQ , 
componentShown() 

JComponent 

ContainerListener 

componentAdded(), 
componentRemoved() 

Container 

FocusListener 

focusGained() , 
focusLostQ 

Component 

ItemListener 

itemStateChanged() 

JList, JCheckBox, JCheckboxMenuItem 

KeyListener 

keyPressedC) , 
keyReleasedQ , 
keyTypedQ 

JComponent 

MouseListener 

mousedicked() , 
mouseEnteredO , 
mouseExited() , 
mousePressedO , 
mouseReleasedO 

3 Component 

MouseMotionListener 

mouseDraggedO , 
mouseMoved() 

JComponent 

WindowListener 

wi ndowClosedO , 
windowClosing() , 
wi ndowDeacti vatedO , 
windowDeiconified() , 
windowIconifiedO , 
windowOpened 

JFrame 


9.7.1 LISTENER ADAPTER CLASSES 

For each AWT listener interface that specifies more than one method, AWT also provides an adapter class. An 
adapter class implements the corresponding interface, defining each method to do nothing-—purely for con¬ 
venience. Because the adapters are classes, you can’t combine two adapters into a single class. Recall that 
Java doesn’t allow multiple inheritance (see Section 7.9, Multiple Inheritance , on page 215). However, you can 
combine one adapter and multiple interfaces. 

For example, we could have implemented our Game Event Hand 1 er by using the MouseAdapter. 

// GameEventHandler2.java - demo MouseAdapter 
import java.awt.event.*; 

class GameEventHandler2 extends MouseAdapter implements ActionListener { 
public void actionPerformed(ActionEvent e) { 

System.out.println("Goodbye!"); 

System.exit(0); 


} 
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public void mousedicked(MouseEvent e) { 

GameBoard board = (GameBoard)e.getSource(); 
int row = e.getYQ / board.getCellHeightC); 
int col = e.getXO / board,getCelIWidth() ; 
if (board.getCel1(row, col) == GameBoard.State.state0) 
board,setCel1( row, col, GameBoard.State.statel); 
el se 

board.setCel1( row, col, GameBoard.State.stateO); 
board.repaint(); 

} 

} 

Because the class MouseAdapter provides “do nothing” implementations of all of the interface MouseLi s~ 
tener methods, we need only redefine the one we care about. 
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9.8 POP-UPS AND DIALOGS 


The GUI programs we have looked at so far always had a single JFrame (or JApplet) that contained all of the 
other GUI components, or so it seemed. The menus in SimplePaintMenu were actually small separate win¬ 
dows that “popped-up” when needed. The standard Java packages provide pre-built classes to handle many 
common pop-up menu and dialog box situations. We present a sampling of them in the following program 

The program PopupMenu is comprised of three classes, PopupMenu which cont ains mai n(), PopupLi stener 
which listens for mouse events that might signify that the popup should be displayed, and PopupMenuLi s- 
tener that responds to chcks on the menu items of the popped-up menu. The program also uses the stan¬ 
dard Java classes I PopupMenu, JOpti onPane, and 3 Fi 1 eChooser. The relationship between the major 
classes in this program can be visualized in the following UML diagram. The black diamond indicates that the 
JPopupMenu is composed of several JMenuItem objects. 
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Here is the main class, PopupMenu. 

// PopupMenu.java 
import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 

class PopupMenu { 

public static void main(String[] args) { 

JFrame frame = new JFrame("PopupMenu Test"); 
Container pane = frame.getContentPaneQ; 
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String[] choices = {"FileChooser", "InputDialog”, 

"Confi rmDialog" , "MessageDialog", ’’Quit"}; 

// create the menu and menu items 
// add the items to the menu 
// attach a listener to each menu item 
JMenuItem item; 

ActionListener listener = new PopupMenuListener(); 

JPopupMenu popup = new JPopupMenuQ; 
for (int i =0; i < choices.1ength; i++) { 
item = new 3MenuItem(choices[i]); 
popup.add(itern); 

itern.addActionListener(1istener); 

} 

// pop-up the menu on mouse clicks 

MouseListener popupListener = new PopupListener(popup); 
frame.addMouseListener(popupListener); 

// just something to give the frame some size 
pane.add(new StarQ); 

frame.pack(); 

frame.setVisible(true); 

} 

} 

The mai n() method begins and ends with the usual 3 Frame operations. The key new element is the class 
JPopupMenu. Tike DMenu, a DPopupMenu can have JMenuItems added to it. We then use a MouseLi stener to 
trigger the popup menu. If you run the program and then right click (control-click on a one button Mac) it will 
look like this: 
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The class PopupListener simply invokes show() for the UPopupMenu when the appropriate mouse event 
occurs. The actual specific type of mouse event that is used to trigger a popup menu is system dependent. 
The method i s Popup!rigger () returns true if a Mouse Event was also a popup trigger. 

// PopupListener.java 
import java.awt.event; 
import javax.swing.*; 
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class PopupListener extends MouseAdapter { 
private JPopupMenu popup; 

PopupListener(JPopupMenu popupMenu) { 
popup = popupMenu; 

} 

public void mousePressed(MouseEvent e) { 
maybeShowPopup(e); 

} 

public void mouseReleased(MouseEvent e) { 
maybeShowPopup(e); 

} 

private void maybeShowPopup(MouseEvent e) { 
if (e.isPopupTriggerQ) { 

popup.show(e.getComponentC), e.getXO, e.getYC)); 

} 

} 

} 

Most of the action for this program takes place In PopupMenuLi stener. 

// PopupMenuListener.java 
import java.awt.*; 
import java.awt.event 
import javax.swing.*; 

class PopupMenuListener implements ActionListener { 
public void actionPerformed(ActionEvent e) { 

String cmd - e.getActionCommandQ ; 

Component parent = (3Component)e.getSource(); 

if (cmd.equals("Fi1eChooser")) { 

// pop-up a file chooser that let's you select a file 
JFi1eChooser choose = new 3FileChooser(); 
choose.showOpenDialog(parent); 

String fileName = choose.getSelectedFile() .getNameO ; 

System.out.println(fi1eName); 

} 

else if (cmd.equalsC'InputDialog")) { 

// Input some string in a dialog box. 

String input = JOptionPane.showInputDialog(parent, "Type something") 
System.out.println(input) ; 

} 

else if (cmd.equals("ConfirmDialog")) { 

// Confirm with Yes/No/Cancel (integers 0/1/2) 

int response = JOptionPane.showConfirmDialog(parent, "Really?"); 

System.out.println("response is " + response); 

} 

else if (cmd.equals("MessageDialog")) { 

JOptionPane.showMessageDialog(nul1, "Your message goes here."); 

} 
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else if (cmd.equals("Quit ,, )) { 

// Confirm with Yes or No 

int response ~ JOptionPane.showConfirmDialog(parent, 

"Really quit?", "Quit", JOptionPane.YES_N0„0PTI0N); 
if (response == JOptionPane.YES„OPTION) { 

System.exit(0); 

} 

} 

} 

} 

The class javax . swi ng. JOpti onPane is highly configurable and can be used lor a wide variety of dialog 
windows. The class has constructors with from 0 to 6 parameters. However, many common interactions can 
be easily handled with one of several static methods. Even these static methods have a variety of options for 
customization. This program demonstrates some of the most common dialogs with minimal customization. 




Dissection of class PopupMenuListener 


# class PopupMenuListener implements ActionListener { 

public void actionPerformed(ActionEvent e) { 

String cmd = e.getActionCommandO; 

Component parent = (JComponent)e.getSourceQ; 

This class responds to menu item selections via an Acti onEvent. We will use the action co mm and for 
the event to determine which menu item was selected. Recall that by default the action command string 
is the same as the label on the menu item. We will also use the source of the event as the parent compo¬ 
nent for the dialogs that we create. Any of the dialogs discussed below can be used in an otherwise non- 
GUI program by simply passing null as the parent component paramete. 

# if (cmd.equalsC'FileChooser")) { 

// pop-up a file chooser that let’s you select a file 
JFileChooser choose = new JFileChooserO; 
choose.showOpenDialog(parent); 

String fileName = choose.getSelectedFi 1 e() .getNameQ ; 

System.out.print1n(fileName); 

} 

The class javax. swi ng. J Fi 1 eChooser presents standard windows for opening and saving files. Here 
we show how to use it to select a file for opening. The only difference between showOpenDi al og () and 
showSaveDi al og() is in the labels for the window. In both cases the user can browse to a selected file 
and the selected file can then be obtained by calling getSelectedFi le(). We have chosen to simply 
print out the name of the selected file for demonstration purposes. The dialog looks like this: 
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} #DialogSampler.java# 
Ball.class 
Bali.java 

BorderLayoutT est. class 
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else if (cmd.equals("InputDialog")) { 

// Input some string in a dialog box. 

String input - JOptionPane.showInputDialogCparent, "Type something”); 

System.out.println(input); 

} 

JOptionPane. showInputDial og() provides a simple way to get text input from the user. This dialog 
can be used in programs that have no other GUI components by simply passing nul 1 in place of parent 
as the first parameter. The dialog looks like this: 
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else if (cmd.equals("ConfirmDialog' f )) { 

// Confirm with Yes/No/Cancel (integers 0/1/2) 

int response = JOptionPane.showConfirmDialog(parent, "Really?"); 

System.out.println("response is " + response); 

} 

JOpti onPane. showConfi rmDi al og() as used here presents the standard Yes/No/Confirm dialog. It 
returns when the user has selected one of the three options. Specific return values can be tested using 
the constants JOptionPane.YES„OPTION, JOption Pane .NO^OPTION, and JOption- 
Pane . CANCEL_OPTION. The dialog looks like this: 
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fm 



|| else if (cmd.equals("MessageDialog")) { 

JOptionPane.showMessageDialog(null, "Your message goes here."); 

} 

This is the simplest of the standard JOptionPane dialogs. It simply prints a message. The method 
returns when the user clicks the OK button displayed with the dialog. The dialog looks like this: 



f> else if (cmd.equals("Quit")) { 

// Confirm with Yes or No 

int response = JOptionPane.showConfirmDialog(parent, 

"Really quit?","Quit", JOptionPane.YES_NO_OPTION); 
if (response = JOptionPane.YES„OPTION) { 

System.exit(0); 

} 

This example shows how the confirm dialog can be customized to show only YES and NO buttons with 
no option for CANCEL. The dialog looks like this: 

















































































































































































































































9,9 Programming Style 293 



9.9 PROGRAMMING STYLE 


For large applications, you need to design the graphical user interface carefully. One useful technique 
involves the use of story boards. Story boards are mock-ups of screen shots from a program. These story 
boards can be used to test the ease of use of a GUI before you write any code. 

To test a GUI using story boards, first create a series of mock-up screen shots, showing the screen as it 
should appear when a user performs a particular task. Then show a test user the first screen and ask the user 
to perform a particular task. The user says out loud what he or she would do—for example, “click on the but¬ 
ton labeled open.” When the user does this, display the story board showing the new appearance of the 
screen to the user. Continue this process until the user successfully completes the task or tries to do some¬ 
thing inappropriate or unexpected. Unexpected behavior may signal the need for changes in the design of the 
GUI. 

You can create story boards with pencil and paper, a computer drawing program, or a GUI builder. Many GUI 
builders for Java allow you to quickly arrange graphical components in a frame or applet. Some even allow 
automatic creation of connections between event sources and event listeners by using direct manipulation of 
the components as displayed on the screen. Using these tools, you can quickly put together a GUI. As with a 
paper story 7 board, you should test these GUIs long before you build the rest of the program by having some¬ 
one try the GUI. When the user clicks the button, you may need to bring up a different display if the action 
associated with the button can’t be built quickly with the GUI builder. 



Summary 


# The class Border Layout is the default layout manager for the content pane of a I Frame. A Border Lay¬ 
out manager places one component on each border and one in the center. 

# With a single container, you are limited to a single layout, such as BorderLayout or GridLayout. By 
nesting one container inside another, you can create many different layouts. The standard plain con¬ 
tainer class is J Panel. 

# A layout manager may attempt to resize—for example, when the user resizes the window on the desktop. 
The layout manager calls the method set Bounds O for the component, indicating the new location and 
size of the component. By defining setBounds () in a class that extends ^Component, you can have a cus¬ 
tom component make adjustments so that any drawing done by the component still fits within the 
resized screen area. 

# All drawing is done on an instance of the class Graphi cs. This class has methods for drawing lines, rect¬ 
angles, ovals, arcs, polygons, and strings. It also has methods for setting the color and font. 

# The basic drawing pen supported by the class Graphi cs draws lines and shapes with only a 1 -pixel-wide 
line. The class Graphi cs2D, which extends Graphics, adds, among other things, the ability to draw wide 
lines and dashed lines. 

# You can add a J Menu Bar to a jF rame with the method setMenuBarQ. A J Menu Bar is a special container 
that can hold several JMenu objects. Each JMenu can contain sub-JMenu objects or JMenuItems. You can 
use these three classes together to create the standard menu bars found at the tops of many applica¬ 
tions. When selected, a JMenuItem generates an Acti onEvent just like a button. 
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# There are different event listener interfaces for the different types of events that can occur. Some event 
hstener interfaces specify several methods. In those cases, there is also an adapter class, which defines 
each method in the interface to do nothing. The adapters are strictly for convenience and provide no 
additional functionality. 

# Java provides the class JPopupMenu that can be used to create menus that pop up in response to some 
action snch as a mouse click. 

H The standard Java class JFi 1 eChooser can be used to create standard file selection dialogs for opening 
or saving files. 

# The standard Java class JOpti onPane provides several useful static methods that can be used to create a 
variety of standard dialog windows such as an alert, simple input, or Yes/No/Cancel. 



Review Questions 


1. What is the default layout manager for the content pane of a 1 Frame object? 

2. How could you create a GUI that has a column of buttons along the left edge and then two large display 
areas on the right? The outline of the components should look like 



3. What type of event listener should you use to respond to selection of a menu item? 

4. How does an event hstener, liste ning to multiple sources, know where the event came from? 

5. What is the difference between MouseLi stener and MouseAdapter? 

6. How do you create cascading menus? 

7. What sort of dashed or dotted line would result from creating a stroke with the following pattern array? 
float[] pattern = { 10.0f, 4,0f, 4.0f, 4.0f, 4.0f, 4.0f }; 

8. What do you need to do if you want to draw thick lines? 

9. There are two different ways to draw polygons using drawPolygonC). Describe them. Which should you 
use if you want to draw the same polygon in several places on the display? 
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Exercises 


1. In a first attempt to create three buttons, we came up with 

//He!loButton3.java 
import javax.swing.*; 
import java.awt.*; 
public class HelloButton3 { 

public static void main(String[] args) { 

JFrame frame = new 3Frame("HelloButton"); 

Container pane = frame.getContentPaneQ; 

JButton hello = new JButton("Hello, world 1!"); 
pane.add(hello); 

^Button more = new JButton("HeHo, world 2!"); 
pane.add(more); 

JButton end = new 3Button("Hello, world 3!"); 

pane.add(end); 

frame.packQ ; 

frame.setVi sible(true); 

} 

} 

Can you explain why only one button is displayed? Fry to rewrite this code and have the buttons dis¬ 
played in a nonoverlapping manner. 

2. Add axes and labels to the class PI ot defined in Section 9.3, Problem Solving: Plotting Data , on page 264. 

3. Use the class PI ot defined in Section 9.3, Problem Solving: Plotting Data, on page 264, to plot 2?c + 3x + 4 
in a stand-alone apphcation using 3Frame. 

4. Redo the previous exercise using a 3Appl et instead of a 3 Frame. 

5. Create a bar-chart component that extends 3 Component. The constructor for the bar chart should take a 
single parameter that is an array of integer values corresponding to the lengths of the bars. Select a 
default size for the component and then scale the bars so that the longest bar is as tall as the component 
is high. Also scale the width of the bars so that they just fill the width of the bar chart. Include a method 
setBounds () so that, if the user resizes the component, the width and height of the bars are adjusted to 
continue to just fill the component. Write a simple program to test your component. 

6. Create a bar-chart drawing class like the one in the previous excercise, but with the added ability to 
superimpose bars for two different arrays of data simultaneously by drawing them in different colors. 
(Hint Always draw the longer bar first and then change the color and draw the shorter bar.) You can use 
predefined constants Col or. red and Col or. bl ue. Test your class in an applet or an apphcation. 

7. Use the class GameBoard as a starting point and create a GUI for the Predator-Prey simulation in Section 
7.7, An Example: Predator-Prey Simulation , on page 207. Use a 10 x 10 square to represent each cell in 
the world. Fill the square with green for grass, red for fox, and pink for rabbits. The user can change any 
square by chcking it. Each chck should change the square to the next value in the cycle of possible values 
(empty, grass, fox, or rabbit). For example, if a square is empty, chcking on it twice will change it to a fox. 
Control the progress of time with a button. Each chck of the button should advance time one generation. 
You can use a BorderLayout, with the world in the center, a Quit button on one border, and the Next 
generation button on another border. 

8. Modify the program in the previous exercise to use a menu. The menu bar should include a Fi 1 e menu 
with the option Exit and a LifeForm menu with the options Empty, Grass, Fox, and Rabbit. The cur¬ 
rently selected life form is used to set a square when the user chcks on a square. 
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9. Use the following code to draw a series of smaller enclosed rectangles of different colors. 

public void paintComponent(Graphics g) { 
g.setColor(Color.white); 
g.fillRect(...); //fill in values 
g.setColor(Color.yellow); 
g.fi11Rect(...); 
g.setColor(Color.green); 
g.fi11Rect(...); 
g.drawRect(...); 

} 

Display your result in a window. 

10. Create an application or applet that can be used to experiment and create colors. The program display 
should contain a rectagular area in the selected color, six buttons, and three text fields. Two buttons and 
a text field are associated with each of the three colors, red, green, and blue. Clicking one of the buttons 
will increase the associated color component, and clicking the other button will decrease it. The text field 
should display the current color component value, which should be in the range 0-255. Also, allow the 
text fields to be edited directly. Each time a component is changed, an area of the display should be filled 
to display the selected color. Create the color with the expression new Color(red, green, blue), 
where red, green, and bl ue are integer values in the range 0-255. 

11. Redo the previous exercise using a menu bar with three menus—one for each of the colors red, green, 
and blue. Each menu should contain items More, Less, Max, and None. 

12. Draw a hexagon whose sides are all the same length. Such a figure is called a regular hexagon. In drawing 
the hexagon, color the interior red and leave the exterior white. 

13. Use a Gri dLayout to draw a series of regular polygons down the screen. Start at the top with a triangle 
and end with an octagon. 

14. Investigate the fonts available on your Java system. Redo the previous exercise, labeling each regular 
polygon with a text field that uses a different font. Your system should support the fonts LucidaSans and 
Roman in plain, bold, and italic. 

15. Develop a simple text window that has a pull-down menu and submenus. Label the chief menu Format 
and the submenus Font, Size, and Style. When these various options are selected, change the text win¬ 
dow accordingly. This procedure is similar to most editing and desktop publishing programs that allow 
you to change fonts. 

16. Create an application or applet for plotting arrays of data using drawPol yLi ne(). 

17. Given the position and velocity of a ball, you can approximate the new position and velocity of the ball 
after time delta with the equations 

x t +delta = x t + vx t x delta; 
y t + delta = y t + vy t x delta; 

vx t +delta = vx t ; 

^1 +delta = v y t - 32 - 

Write an application or an applet to simulate a bouncing ball. To begin you can control 1 he simulation by 
clicking a button for each tick of the clock. At each tick, compute the new position of the ball and draw it. 
Assume that the ball is in a box and reverse the sign of the y velocity component whenever t he ball hits 
the top or bottom of the box. Likewise, reverse the sign of the x velocity component whenever the ball 
hits either side of the box. To get your simulation to run automatically, you can use the following tem¬ 
plate. (The method si eep() is discussed in Section 13.7.1, Calling sleepQ from Anywhere , on page 410.) 
The class Ball is similar to the sample drawing classes such as Star and others. 
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//BoundngBall.java - driver for ball simulation 
class BouncingBal1 { 

public static void main(String[] args) 

// the following is needed when calling sleep 
// see Chapter 11 for more about exceptions 
throws InterruptedException 

{ 

Ball ball = new Ball(); 

// code to create a JFrame, add ball to its 
// container pane and show the JFrame goes here 
Thread self = Thread.currentThreadC); 
while (true) { 

//call some method in Ball to set new position 
bal1.repaint(); 

self.sleep(100); //pauses l/10th second 

} 

} 

} 

18. Create an application or an applet that lets the user select from a hst of functions, specify a range of val¬ 
ues and a delta, and then plot the function. Provide a menu of functions from which the user can choose. 

19. A J Button can be used to select one of several options by changing the label of the J Button. Create a 
test program that uses a button to cycle among four labels: empty, grass, rabbit, and fox. Each time the 
button is chcked the label should be changed to the next label in the cycle. Use an Acti onLi stener to 
echo to the console the currently selected label. 
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In our programs so far, user input has been from the keyboard or mouse. All output has been printed to the 
console or displayed in a graphical user interface. In this chapter we show you how to read data from a file 
and write data to a file. 


Excluding graphical input and output, all input and output (I/O) in Java is done with streams. A Java stream 
is a sequence of bytes. An input stream can come from a file, from keystrokes at the console, or from a net- 
work. Likewise, an output stream may go to a file, to the console screen, or out over a network. At the top 
level, the same classes are used for all types of stream input and output. The primary differences among the 
various classes we present are caused by the need for different byte streams to be reassembled differently to 
form meaningful values inside a program. 




on whether they correspond to 
. In the same way, you can interpret a 


If you have some sequence of 32 bits, 
an i nt, a float, two 16-bit Unicode characters, or 
stream of bytes in different ways. You must be careful to match the method used to write the stream with 
the method used to read the stream. 



10.1 TYPES OF FILES 


In Java, as with most operating systems today, files can 
binary files. 


be broken into two broad categories: text files and 


In a text file , each byte is interpreted as a single character. In most cases the character set is the ASCII charac¬ 
ter set. You can display a text file by using almost any editor on your computer. A text file may use special 
sequences of characters to encode text formatting or other information. For example, HTML files used on the 
Internet are text files with tags for formatting. Recall that HTML tags are generally enclosed by angle brackets 
<1 i ke thi s>. The source files for Java programs are text files. 


The other broad category of files is binary files, which includes everything but text files. Binary files typically 
use the same bit patterns to represent data as those used to represent the data in the computer’s main mem¬ 
ory. These files are called binary files because the only thing they have in common is that they store the data 
as sequences of Os and Is. There are a huge number of different binary file formats—Java class files, execut¬ 
able images for your computer, the normal file format for most word processors, the image and audio files 
used for the Internet, and many more. 
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Reading and Writing Fifes 


For example, suppose that you wanted to store a sequence of i nt values in a file. You know that an integer is 
32 bits, or 4 bytes, long, so you could just place the 4 bytes for each integer in the file, one after another, to 
create a binary file. That would also be a very compact way of storing the integers. However, if you tried to 
look at this file with a normal editor, you would just get garbage on your screen. The reason is that the editor 
expects characters and wouldn’t recognize that you were encoding integers. The editor would interpret each 
byte as an ASCII character that in no way resembles the text representation of the corresponding integer. For 
example, the i nt value 1234 occupies 32 bits, or 4 bytes. The binary representation of 1234 is the sequence 
of Os and Is in the following figure. The 32-bit sequence has been divided into the four 8-bit bytes. 


byteO 

bytel 

byte2 

byte3 

00000000 


00000000 


00000100 


11010010 


If each byte is viewed as an integer (see Section A.1, Integer Binary Representation , on page 425), you would 
get the following: 


byteO 

0 


bytel 

0 


byte2 

4 


byte3 

210 


Unlike Java, most text editors use ASCII values instead of Unicode. To a text editor, none of these 4 bytes cor¬ 
respond to printable ASCII characters. For comparison, here are the four bytes needed to represent the text 
string "1234". 


byteO 

bytel 

byte2 

byte 3 

49 


50 


51 


52 


The ASCII code for the digit 1 is 49, the code for the digit 2 is 50, and so on. If what you cared about was 
space on the disk for storing the numbers, the binary representation might be the right choice. Although 
1234 takes 4 bytes in either format, any integer value greater than 9999 will require more than 4 bytes when 
stored as text. Recall that 4 bytes are sufficient to store numbers as large as 2 billion, or 10 decimal digits, 
when stored in binary form. 

Instead of writing the 4 bytes of an i nt to a file, you can write the sequence of text characters used to repre¬ 
sent the number. Such sequences would include the 10 digits and possibly the minus sign. You would also 
have to use some special character to separate one number from the next—for example, a space or a comma. 
This format would be a text file, which would use much more space on your computer’s disk. If you wanted 
to be able to view or modify the file with an editor or use e-mail to send the numbers to someone else, this 
format might be preferable. 

Java’s standard package j ava. i o contains classes that support the reading and writing of both binary and 
text files. 
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10.2 WRITING TEXT FILES 


The simplest way to write text to a file is to use the class Pri ntWri ter from the standard package java. io. 
The class Pri ntWri ter has the f amili ar methods pri nt () and pri nt i n() that we’ve been using to write to 
the console. The class Pri ntWri ter has a constructor that takes the name of a file as a string. 

//HelloFile. java - writing to a file 
import java. io.PrintWriter; 
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class HelloFile { 

public static void main(String[] args) throws java.io.IOException 

{ 

PrintWriter out = new PrintWriter("hello.txt"); 
out.println("Hello, file system!"); 
out.closet); 

} 


If you run this program, it will create a file, hello.txt , which you can view with any text editor. The contents of 
the file will be the one line “Hello, file system!”. 




Dissection of the Class He! 1 oFi 1 e 


• import java.io.PrintWriter; 

We must import Pri ntWri ter from the package java. i o. 

# public static void main(String[] args) throws java.io.IOException 

Many of the methods for I/O can generate an I/O exception. As discussed in Chapter 11, Coping with 
Errors , an exception is something unexpected that occurs. Often an exception is really an error. In this 
example, if the output file couldn’t be opened for some reason, an IOExcepti on would be generated. A 
statement or method that generates an exception is said to throw an exception. The class IOExcepti on 
is defined in the package j ava. i o. We can either give the full name of the exception, j ava. i o. IOEx¬ 
cepti on, as in this example, or we could change the import to j ava. i o. * and then use the shorter 
name, IOExcepti on. 

• PrintWriter out = new PrintWriter("hel1o.txt"); 

The class Pri ntWri ter needs the name of the file as a string. This name can include directory informa¬ 
tion, which is platform dependent. When no directory information is specified, the file is created in the 
operating system’s notion of the current directory. 

# out.println(”Hello file system!"); 
out.close(); 

Anything that we can do with System.out.printQ or System.out. printlnC) we can do with the 
corresponding method from Pri ntWri ter. Closing the file when the program terminates is essential. 
Failure to close the Pri ntWri ter stream may cause some or all of the output not to appear in the file. 
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10.3 READING TEXT FILES 


Reading a text file is as easy as reading from the keyboard. All along we’ve been using the class Scanner to 
read from the console via new Scanner (System. i n). We can just as easily create a Scanner that is associ¬ 
ated with some file. The following program reads in the file that we wrote in Hel 1 oFi 1 e, printing each 
“token” on a separate line. In this case, a token is a white space delimited string. 

//HelloFileRead.java - reading a text file 
import java.uti1.Scanner; 
import java.io.*; 
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class HelloFileRead { 

public static void main(String[] args) throws IOException 
{ ' 

Scanner input = new Scanner(new File("hello.txt")); 
while (input.hasNextO) { 

System. out. pri ntl n(i nput. nextQ) ; 

} 

} 


We can of course use any of the Scanner methods to parse the input as desired. In the next example, we use 
a Scanner object to read one i nt, one double, and one Stri ng from the file sample.txt. 

//Fi1eReadlnput - reading primitive values from a file 
import java.uti1.Scanner; 
import java.io.*; 

class FileReadlnput { 

public static void main(String[] args) throws IOException 

{ 

Scanner input = new Scanner(new File("sample.txt")); 
int x = input.nextlnt(); 
double y = input.nextDouble(); 

String s = input.next(); 

System.out.println(”x = "+x); 

System.out.println("y = "+y); 

System.out.println("s = M +s) ; 

} 


The first thing in the file sample.txt is expected to be a sequence of characters representing an integer, the 
next a floating point value, and, finally, anything. The method next () returns the next white-space-delimited 
sequence of characters in the input. If the file sample.txt contains the single line 

-1234 0.0001234 1234 567 
the output would be 


x = -1234 
y = 1.234E-4 
s - 1234 


The third input item, 1234, was actually read as a string. Note that it stopped at the white space between 
1234 and 567. 

The next program counts the number of words in a file. 

//WordCount.java - count the words in a file 
import java.uti1.Scanner; 
import java.io.*; 

class WordCount { 

public static void main(String[] args) throws IOException 

{ 

Scanner input = new Scanner(new File(args[0])); 
int count = 0; 
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while (input.hasNextQ) { 

String word = input.next(); 
count++; 

} 

System.out.println("There were "+count+" words."); 

} 

} 


10.3.1 PARSING TEXT STREAMS 

The Scanner class is quite versatile and can satisfy many input and string parsing needs. For example you 
can change the delimiter for a Scanner to be some thin g other than one or more white space characters using 
the method Scanner. useDel i mi ter (). You can also use a Scanner to parse arbitrary strings in a program. 
The expression new Scanner (someStri ng) creates a Scanner that “reads” from the given string. For exam¬ 
ple the following code fragment prints 1234. 

int x = new Scanner("1234 abc").nextlnt(); 

System.out.println(x); 

The delimiter is specified by a string representing a regular expression. See the Java documentation for 
java. uti 1. regex. Pattern for more information about regular expressions in Java. As an example suppose 
we would like the delimiter to be a comma. The following example shows how to do this. 

Scanner input = new Scanner("123,456,789"); 
input.useDelimi ter(","); 

System.out.print(input.nextlnt() + " "); 

System.out.print(input.nextlnt() + " "); 

System.out.println(input.nextlnt()); 

The output from the above frament is 123 456 789. You need to be careful when changing the delimiter. 
There is no implicit removal of white space once you change the delimiter. For example, if the string passed 
to create in the above example was changed to "123, 456, 789" by adding spaces, the program would fail 
throwing anlnputMismatchException. Here is a slightly more complicated version that uses as a delimiter 
a comma, possibly surrounded by one or more white space characters. 

input.useDelimi ter("\\s*,\\s*"); 

The double backslash characters are string escape sequences that translate to a single backslash so the 
parameter to useDel i mi ter() is a string with seven characters: backslash, s, *, comma, backslash, s, and *. 
The sequence \s matches any white space character. The * means repeat the previous pattern zero or more 
times. So the result is that this delimiter pattern matches zero or more white space characters, then a 
comma, then zero or more additional white space characters. The following code fragment demonstrates 
this. 

Scanner input = new Scanner("123 , \n456, \t789"); 

input.useDelimi ter("\\s*,\\s*"); 

System.out.print(input.nextlntQ + " ") ; 

System.out.print(input.nextlntO + " ") ; 

System.out. pri ntl n(i nput. nextlntO) ; 

The output from this fragment is 12 3 456 789. Recall that \n and \t are the string escape sequences for 
newline and tab, both of which are white space characters. 


If you have a string that you know contains just a single primitive value, you can alternatively use methods in 
the classes Integer, Long, Float, and Double to convert the string to the appropriate value. 
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Type represented by String s 

Convert with 

i nt 

Integer.parselnt(s.trim()) 

long 

: Long.parseLong(s.trim()) 

float 

Float. parse FI oat (s. trimQ) 

double 

Double.parseDouble(s.trim()) 


The method trim() from the class Stri ng trims any leading or trading white space. The methods parse 
Type () will throw a Number For mat Excepti on if they encounter white space in the string being converted. 



10.4 FORMATTING TEXT OUTPUT 


Most progr ammin g languages provide some form of formatted output. Formatted output takes two general 
forms. The approach used for stream output in the programming language C++ is to have the stream remem¬ 
ber how certain values should be formatted. A mechanism is then provided for changing the formatting 
information in the stream. For example, to print three integers i, j, and k in columns 10 characters wide, 
using C++ streams, we would use 

cout « setw(10) « i « j « k; 

In C++ co ut is the name of the standard output stream, which is analagous to System.outin Java. The sym¬ 
bol « is an operator that sends its right operand to the stream that is the left operand. The value of the 
expression stream « val ue is the stream after doing whatever it is supposed to do with val ue. Thus, 
when evaluated from left to right, the expression first sends out the formatting command setw(10), which 
sets the width of the subsequent output fields to be 10 characters wide. Then the Integers i, j, and k are sent 
in order. 

In the other form, some type of formatting information is included in the statement that does the printing. 
This is the approach used by Java (beginning with version 5.0) and the programming language C. To print 
three integers i, j, and k in columns 10 characters wide in Java we can use: 

System.out.printf("%-10d %~10d %-10d", i, j, k); 

We can of course do this type of printing not only with the Pri ntStream referred to by System. out, but 
using any reference toaPrintWriteror PrintStream object. The first parameter for the method printfQ 
is a format string. The percent sign marks the format specification for one value to be printed. The ~10d indi¬ 
cates that the value is an integer (d for decimal) in a field 10 characters wide that is left-justified in the field. 
The specification %10d makes the value right-justified in the field. Similar format specifications are provided 
for printing strings, floating point values, and other types. 

The formatting capability provided by pri nf () in Java is quite extensive and is fully documented in the class 
java, uti 1. Formatter. We provide a description of a subset of that functionality here. 

A format string consists of conversion specifications intermixed with plain text. The general form of a con¬ 
version specification is 

% [arguments ndex$] [flags] [width] [. preci si on] conversion 

The square brackets indicate optional portions of the conversion specification. The meaning and permiss- 
ability of the optional portions depends upon the conversion character(s). The conversion part of the specifi¬ 
cation is either one character, or two characters where the first is l t’ or T\ 
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10*4.1 CONVERSION CHARACTERS 

Some conversions are only valid for specific types of arguments. There are five categories of conversions 
which indicate the types of legal aguments for conversions in that category. In addition, the two conversion 
characters, % and n do not correspond to any arguments. The conversion character % produces a % in the out¬ 
put string. The conversion character n produces a platform dependent line separator in the result string. 
This line separator may be either 1 or 2 characters long. Here are the five categories of conversions that do 
apply to some type of argument. 

1. General - can be used with any argument type. 

2. Character - used with char, Character, byte, Byte, short, Short, i nt, and Integer. This con¬ 
version is only valid for i nt and Integer if the argument is between 0 and 0xl0FFFF inclusive. 

3. Integral - used with byte, Byte, short, Short, i nt, Integer, 1 ong, Long, and Biglnteger. 

4. Floating Point - used with f 1 oat, FI oat, doubl e, Doubl e, and Bi gDeci mal. 

5. Date/Time - used with 1 ong, Long, Cal endar, and Date, 

The conversion characters are described briefly in the following table. In some cases we have made unstated 
simplifying assumptions or omissions for brevity. You should consult the Java specification for the complete 
details. 


I 

Symbo* 

|j|! 1 s||a^gor yj j§j| 

.. : • ;!iV:r.:L:JI; 1 ii:! 1;:L:!: : !.:: : ^^ 

Description 

b 

general 

For boolean types, the result is true or fal se. For 
null the result is fal se. For all other non-boolean 
values the result is true. 

h 

general 

The hexadecimal value of the hash code of the argu¬ 
ment or nul 1 if the argument is nul 1. 

s 

general 

The normal string representation of primitives or the 
result of calling toStri ng() for non-primitive types. 

c 

character 

A Unicode character. 

d 

integral 

A decimal integer. 

o 

integral 

An octal integer. 

X 

integral 

A hexadecimal integer. 

e 

floating point 

Computer rendering of scientific notation. The same 
notation used for floating point literals. 

f 

floatmt point 

A decimal number (no exponent). 

g 

floating point 

The same as either e or f depending upon the mag- 
nitue of the argument. 

a 

floating point 

A hexadecimal floating point value. 

t 

date/time 

Prefix indicating one more conversion character fol¬ 
lows. See the Java specification for details. 

% 

no arg 

Produces a % in the result. 

n 

no arg 

Produces a platform dependent line separator. 

---—^-- 


The conversion characters applicable to numeric types can be modified with one or more flags as shown in 
the following table. In addition, the flag is applicable to all conversion specifications. 
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Flag 


Description 

; ... . 

; -Ill.: : ;%m 

:::?: : " * : *:) ' - ■ :: : - * 

..nil m mi. 


The result will be left justified in the field. The default is right justification. 

# 

A conversion character specific alternate format should be used. 

4- 

Always Include a + for postive values. The default is no + sign. 

6 i 

Insert a leading space in front of postive values. An Ill eg a! Format FI ag- 
sExcepti on will be thrown if both 1 1 and + are present. 

0 

Pad with leading zeros instead of spaces to fill the field. 

J 

Locale specific grouping characters will be inserted e.g. 123,456 in the US). 

( 

Negative numbers will be enclosed in paretheses. 


10.4.2 WIDTH AND PRECISION SPECIFICATIONS 

The width specifier in a conversion specification is a positive integer specifying the minimum number of 
characters that should be inserted into the result for this conversion. If no width specifier is included then 
just enough characters to hold the converted value are included in the result. 

The precision specifier is interpreted differently for different conversion characters as shown in the fol low¬ 
ing table. If a conversion character is not shown in the table then the precision specification is not allowed 
and its presence will result in an exception. 


Conversion 

Characters 

Effect of Precision Specification 

ms 

e, f 

The precision specifies the number of digits that will be 
shown to the right of the decimal point. 

9 

The precision specifies the maximum number of significant 
digits that will be shown in the result. 

b, h, s 

The precision specifies the maximum number of characters 
that will be shown for this argument. 


10.43 SELECTING ARGUMENTS FOR CONVERSION 


By default the conversion specifications are matched, in order, with the arguments following the format 
string. This can be modified using the argument_index$ portion of a conversion specification. 


The argument index, if present, is used to indicate which of the arguments following the format string this 
conversion specification should be applied to. The first argument following the format string is 1$, the sec¬ 
ond 2 $, and so on. Arguments may be referenced by more than one argument index. The conversion specifi¬ 
cations that do not include an argument index are assigned implicit argument indicies in order, ignoring 
conversion specifications that have explicit argument indicies. For example, in "%s %3$d %s %2$d %s", the 
three "%s" conversions will be apphed to arguments 1,2, and 3, in that order. 













































































10.4A Java's prmtfO versus Cs 307 


10.4.4 JAVA’S PRINTFO VERSUS CS 

For readers already familiar with programming in C, the influence of C’s pri ntf () on Java’s pri ntf 0 is 
obvious. What may not be so obvious are the differences. We would like to bring your attention to a few of 
them. 

The most important difference is that in Java, if you attempt to apply a format conversion to the wrong type 
of argument, the pri ntf () will throw an exception. In C, the program will print something, most likely gar¬ 
bage. 

Similarly, in Java if you fail to provide as many arguments as there are conversion specifiers in the format 
string, the pri ntf () will throw an exception. In C, the program will quietly print garbage. 

Of less importance are some small differences in the format specifications. For example, C uses the precision 
specification with integral conversions to specify the minimu m number of digits to print - padding with lead¬ 
ing zeros if necessary. Also C has fewer conversion characters, for example, there are no conversions specifi¬ 
cally for date and time, and C does not have a boolean type. 


10.4.5 VAR ARCS 

The pri ntf () facility in Java uses another feature that is new in Java 5.0, namely variable length argument 
lists, or “var args” for short. Variable argument support is a modest extension of the autoboxing feature 
dicussed in Section 7.11.2, Automatic Boxing of Primitives, on page 220. It gives the appearance of having a 
single method that accepts a variable number of arguments of unspecified types. This is actually achieved by 
passing an array of Object that is automatically constructed at the call site. This is shown in the following 
example. 

//VarArgs.java - demonstrate variable argument lists 
class VarArgs { 

public static void main(String[] args) { 
varArgs(1,2,"three",4.4) ; 
varArgs("five",6); 
varArgsQ ; 

} 

static void varArgs(Object... args) { 
for(0bject obj : args) { 

System.out.print(obj + ", "); 

} 

if (args.length > 0) 

System.out.println(args[0]); 
else 

System.out.printIn("no args"); 

} 

} 
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Dissection of VarArgsJava 


(J //VarArgs.java - demonstrate variable argument lists 
class VarArgs { 

public static void main(String[] args) { 
varArgs(l,2,"three" ,4.4) ; 
varArgs("five",6); 
varArgsQ; 

} 

We call the method varArgs () once with 4 arguments, once with two, and once with zero arguments. In 
addition, the types of the arguments vary. Without variable argument support, this would only be legal if 
we provided three overloaded definitions of varArgs () with the appropriate number and type of param¬ 
eters. Using the variable argument support we only need one method definition. 

• static void varArgsCObject... args) { 

The parameter type Object... declares that this method expects an array of Object. Except for the 
autoboxing at t he call site, it is just as if the method had instead been declared as 

static void varArgsCObject[] args) { 

The ... is the signal to the compiler to box any primitive values and combine all of the parameters into 
an array. 

% for(Object obj : args) { 

System.out.print(obj + ", "); 

} 

We use this loop to print each of the arguments. 


# if (args.length > 0) 

System.out.println(args[0]); 

This shows that args is indeed an array and normal array indexing is allowed. 

% else 

System.out.println("no args"); 

This shows that indeed you can call the method even with zero parameters, in which case you get an 
array of length zero. 



You can use the . . . for variable arguments with any Java type. For example, here is the same example but 
with a variable number of integers being passed. 

//IntVarArgs.java - demonstrate variable argument lists 
class IntVarArgs { 

public static void main(String[] args) { 
varArgs(l,2,3); 
varArgs(l,2); 
varArgsQ; 


} 
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static void varArgs(int.,. args) { 
for(int str : args) { 

System.out.print(str + ", "); 

} 

if (args.length > 0) 

System.out.println(args[0]); 
el se 

System.out.println("no args"); 

} 

} 

The variable arguments facility should be used sparingly, only when absolutely required. It should not be 
used to undermine the strong type checking of Java. For example, if you have a method that works with 
either 2 or 3 integers, you should create two overloaded methods instead of using variable arguments. The 
problem with using variable arguments when overloading will suffice is that it moves error detection from 
compile time to run time. For example, with method overloading if you supply too few parameters you get a 
syntax error from the compiler. Using var args you will not detect a shortage of parameters until runtime, if 
at all. The shortage might appear as an Ar raylndexOutOf BoundsExcepti on, or worse it might simply go 
undected causing erroneous output. 
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0.5 PROBLEM SOLVING: ENCRYPTING TEXT FILES 


An important technique for providing security lor files is encryption. In ordinary text, called clear text , the 
text is written in words that are part of the reader’s vocabulary . In this book, that vocabulary 7 is English. With 
encryption, the text is transformed to apparently meaningless characters. Typically, encryption is done with 
an algorithm called a cipher. For example, a simple cipher is the Caesar cipher. Here the algorithm replaces 
each clear text letter by a letter chosen to be n places later in the alphabet. The number of places, n, is called 
the cipher key. For example, if the key is 1, the clear text “I came, I saw, I conquered.” becomes “J dbnf, J tbx, 
J dporvfsfe.” 

The characters in Java are encoded as Unicode, and these codes are 2-byte integers. For example, the charac¬ 
ter T A' is the number 65 and the character 1 a' is the number 97. The blank character ' ’ is the integer 32. 
We restrict our discussion here to encoding the uppercase alphabetic characters. The set of characters ' A', 
1 B', ..' Z' correspond to the integers 65-90. 

The Caesar cipher can be implemented as a Java method that transforms the character value by the value of 
the key. 

//Caesar Cipher method 

static char caesarCipher(char c, int key) { 
return (c - 'A' + key) % 26 + ’A ! ; 

} 

This code is easy to break because it relies on a very simple substitution. If we have a long message in this 
cipher, we can use frequency tables to decrypt this cipher (see Exercise 15 on page 368). Or we can write a 
program that runs through the keys 1-26 and see if they yield clear text. 

A slight generalization of the Caesar cipher is the Vignere cipher . Here we use a repeated series of displace¬ 
ments such as 1 3 5 to produce the text. 

Cleartext I AM GOING TO UCSC 

Offset 1 35 13513 51 3513 

Vignere cipher 3 DR HRNOJ VP XHTF 

One immediate improvement is that different occurrences of a particular letter are mapped to different 
cipher letters. For example, the first I in the example above is mapped to J but the I in GOING is mapped to 
N. The longer the Vignere key, the better the cipher. Such an encryption method can be coded in the following 
form. 
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//Vignere Cipher method 

static char vignereCipher(char c, int[] key) { 

//left as an exercise 

} 

This code is more difficult to break. Indeed, the longer the sequence of keys, the harder it is to break the 
cipher. If the key is as long as the clear text, we have the Vernam cipher, better known as a one-time pad. 
Such a system is provably unbreakable. If the one-time pad involves a randomly generated set of displace¬ 
ments, the cipher is random and only someone with the key can decrypt it. 

We can simulate such a scheme by using a pseudorandom number generator to produce the one-time pad. 
Our scheme first involves taking the uppercase alphabet and mapping it onto 0-25. Next, we add in random¬ 
Letter— a value between 0 and 25, inclusive. We now have values between 0 and 50 that are pseudorandom, 
and we map them back onto the values 0-25 and add ' A 1 to get Unicode character values for the characters 
in the cipher text. Thus our total encryption formula is 

CCc - 'A' + randomLetter) % 26 + 'A') 

and the corresponding decryption formula is 

CCc - 'A' + 26 - randomLetter) % 26 + 'A’) 

We must start encryption and decryption at the same point in our pseudorandom sequence. What happens if 
we forget to do so? (See Exercise 16 on page 321.) 

Let’s use our random number simulation of the one-time pad to encrypt the characters of clear text. In our 
code we use the class Random to obtain appropriate random numbers. It is found in j ava. uti 1 . Random. The 
method nextDoubl e() acting on a Random object returns a random value between 0 and 1. Extending this to 
decryption is left for you to do as Exercise 17 on page 368. 

//VernamCipher.java - cipher based on random pad 
import java.io.*; 

import java.util.*; //random number methods 

* 

class VernamCipher{ 

public static void main(String[] args) throws lOException 

{ 


if (args.length < 3) { 

System.out.print!n("Usage: " + 

"java VernamCipher clearFile codeFile key(an int)"); 
System.exit(l); 

} 

// open the input and output files 
Scanner in = new Scanner(new File(args[0])); 

PrintWriter out = new PrintWriter(args[1]); 

// use the key to start the pseudo-random sequence 
Random r = new Random(Integer.parselnt(args[2])); 

// encrypt one line at a time 
whi1e (in.hasNext()){ 

out.println(encrypt(in.nextLine(), r)); 

} 

in.closeO; 
out.closeQ ; 
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Encrypt one string using a Vernam cipher. 

©param message - a string to be encrypted 

©param r - the source of random characters for the encryption 
©return the encrypted string 

*/ 

public static String encrypt(String message, Random r) 

{ 

// for monitoring purposes print the unencrypted string 
System.out.println(message); 
char c; 

// for efficiency use a StringBuffer instead of a String 
StringBuffer cipher = new StringBuffer(message. lengthO) ; 

for (int i = 0; i < message.1ength(); i++){ 
c = message.charAt(i); 
if (Character.isletter(c)) { 

// for simplicity we only handle upper case letters 
int newc = Character.toUpperCase(c) - 'A'; 
newc = (newc + (int)(r.nextDouble() * 26)) % 26 + ’A'; 
cipher.append( (char)newc ); 

} 

else { 

// don't change non-letters 
cipher.append(c); 

} 

} 

String result = cipher.toStringO ; 

// for monitoring purposes print the encrypted string 
System.out.println(result); 
return result; 

} 

} 
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10.6 READING AND WRITING BINARY FILES 


For development purposes, you should use text files whenever possible. When that isn’t possible or desir¬ 
able, you can use the two classes DatalnputStream and DataOutputStream to read and write binary files. 
The methods in DatalnputStream include 

readBooleanQ 

readByteO 

readChar() 

readDoubleO 

readFloatQ 

readlnt() 

readLongO 

readShort() 

readUTFO 

Each method has a counterpart in DataOutputStream that begins with wri te instead of read. In each case 
the method reads or writes the specified primitive type, or in the case of UTF, it reads or writes string values. 
The strings are encoded with a modified UTF-8 format; hence the name of the method. This format allows 
Unicode strings composed entirely of characters from the ASCII set to be encoded with 1 byte per character 
instead of the 2 bytes required for Unicode characters without any encoding. 
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There is no type information stored in a binary file other than information that is exphcitly written by the 
program creating the binary file. Therefore it is essential that the sequence of reads when reading a file must 
exactly match the sequence of writes used to generate the file. 

in the following program, 1 i nt and 10 doubl e values are written to a file and then are read back in from the 
file. Note that nothing is written to the file to separate the values. The binary format knows to read 4 bytes 
for an i nt and 8 bytes for a doubl e. If you try to view the output file test.bin with an editor, you will see gar¬ 
bage. Again, we need two classes to read (or write) a file. The class DatalnputStream has the desired meth¬ 
ods readlnt () and so on, and the class Fi lelnputStream creates a byte stream from a file. 

//BinIOTest.java 
import java.io.*; 

class BinIOTest { 

public static void main(String[] args) throws IOException { 

DataOutputStream out = 

new DataOutputStream(new Fi1eOutputStreamC'test.bin")); 
double x = 1.0; 
int count = 10; 
out.writelnt(count); 
for (int i = 0; i < count; i++) { 
out.writeDouble(x); 
x = x / 3.0; 

} 

out .closeO ; 

DatalnputStream in = new DataInputStream(new FileInputStream("test.bin M )) ; 

count = in.readlntO; 

for (int i = 0; i < count; i++) { 

System.out.pri ntl n(i n. readDoubleQ) ; 

} 

} 

} 

Compare the preceding example with the following example, which does the same thing but with a text file. 
Here we use pri ntl n () to place a newline character between each consecutive pair of values in the file. With¬ 
out these newline characters, all the characters would run together, and we wouldn’t know where one num¬ 
ber ends and the next begins. The file test.txt can be viewed with any standard text editor. If this were a real 
application that was storing millions of values instead of 10 values, the execution time and size difference of 
the two resulting files, test.bin and test.txt, would be substantial. 

//TextIOTest.java 
import java.io.*; 
import java.util.Scanner; 

class TextIOTest { 

public static void main(String[] args) throws IOException 

{ 


PrintWriter out = new PrintWriter("test.txt"); 
double x = 1.0; 
int count = 10; 
out.println(count); 
for (int i =0; i < count; i++){ 
out.println(x); 
x = x / 3.0; 

} 

out.closeQ ; 











10,7 Detecting the End of an Input Stream 3 7 3 

Scanner in = new Scanner(new File("test.txt")); 

count = in.nextlnt(); 

for (int i = 0; i < count; i++){ 

System .out, pri ntl n(i n. nextDoubleO); 

} 

} 

} 

Trying to use a DatalnputStream object to read from System, i n is tempting. Although the following pro¬ 
gram will compile and execute, it won’t give the expected results for text based input. As we explained in Sec¬ 
tion 10.1, Types of Files, on page 299, the DatalnputStream is interpreting each byte as 1 byte of a 4-byte 
integer. However, the bytes produced by the keyboard are the ASCII representations of each digit. 

//MisuseDatalnputStream.java - doesn’t read correctly 
import java.io.*; 

class MisuseDatalnputStream { 

public static void main(String[] args) throws IOException { 

DatalnputStream input = new DataInputStream(System.in); 

System.out.println("Enter 4 integers."); 
for (int i - 0; i < 4; i++){ 
int value = input. readlntQ ; 

System.out.println("You entered " + value); 

} 

} 

} 


Common Programming Error 

Care must be taken when you’re writing files. Depending on the operating system you’re using and the 
file protections that are set, it may be possible to accidentally overwrite an existing file. In general, Java 
systems allow you to open an existing file for output. Using the methods previously described, any exist¬ 
ing data are replaced with the new data. For example, if you execute the program Hel 1 oFi 1 e while in a 
directory that already contains a file named hello.txt , any data previously in the file are lost and no warn¬ 
ing will be given. 

To append data to an existing file you can use the class RandomAccessFi 1 e. This class is intended for 
use with binary files and provides methods similar to those in the classes DatalnputStream and 
DataOutputStream. In addition, it allows you to skip to the end of the file before beginning to write. 

Another way to append data to a file is to create an output stream and copy the existing file to a tempo¬ 
rary file. Then using the same output stream, you can append new data. When finished, you can close the 
output stream and rename the temporary file using the method renameTo () in the class j ava. i o. Fi 1 e. 
If you take this approach, be sure to select a long meaningless file name for the temporary file. A good 
solution is to name the file some thin g like tempi 23456, where the digits are chosen randomly by calling 
Math. random (). An even better solutionis to use the method Fi 1e. createTempFi 1 e(), which creates a 
temporary file in the operating system’s default temporary directory . 

The class Fi le also has methods that allow you to determine whether a file already exists and, if so, 
whether the file can be read or written. 



10.7 DETECTING THE END OF AN INPUT STREAM 


Because streams are most often, at least historically, associated with files, the end of a stream is referred to 
as end-of-file (EOF). Detecting the end of a stream varies from class to class. The EOF is a sentinel, or guard, 
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value that Is important for most file-reading progr ammin g idioms. Its detection is often used to terminate 
processing on that file. 

If you’re using the class Scanner, you can test whether more text rem ain s to be read by calling hasNex- 
tXXX() where XXX can be any of several different things such as Int or Float. If you fail to check for EOF by 
calling one of these “hasNext” methods and try to read beyond the end of the stream, the read operation will 
throw a NoSuchElementException. 

A third way of signalling EOF can be found in java, i o. Buffered Reader, among other places. The method 
BufferedReader. readLi ne() reads the next line of input and returns it as a Stri ng. If there are no charac¬ 
ters to return because the EOF has been reached then the method returns null. For methods such as read¬ 
Li ne () that return a value of type Stri ng, the value null is a legal return value that doesn’t correspond to 
any string value that could be read in. Note that nul 1 isn’t the same as the empty string, ,,M . An empty string 
occurs if a line containing nothing but a newline character is read, which is quite different from encountering 
the EOF. 


The class DatalnputStream uses both throwing an exception and returning a distinguished value to signal 
EOF. The methods for reading specific primitive values discussed in this chapter throw an EOFException 
when you try to read beyond the end of a stream. However, DatalnputStream also includes methods for 
reading individual bytes that don’t throw EOFExcepti ons. For example, the method readQ returns the next 
byte as an i nt value between 0 and 255, inclusive. If the end of the stream has been reached, the method 
returns -1. The class DatalnputStream also contains a method readLi ne() that tries to interpret bytes as a 
string in much the same way as readLi ne() in Readlnput. The version in DatalnputStream doesn’t always 
work correctly, shouldn’t be used, and is being phased out. If you try to use it, you’ll get a warning message 
that the method has been deprecated. This message means that the method may not be available in future 
versions of Java. For reading complete lines of text, the method readLi ne() in the standard Java class Buff- 
eredReader can be used. 


We su 


nm 


arize this information in the following table. 


isxx-xxx-Xxx-xxx'x-xxM ?;' ...: : .ox: : :-:: 

Class 

Method 

; : x:':' : xx’:x x*:*x x: xVx^x-xx: x :3'-S&'X‘ ; : : 'Xx:-x'x; 

EOF DETECTED BY 

java.util.Scanner 

nextXXXC) 

hasNextXXXQ ; 

NoSuchElementException 

java.io.DatalnputStream 

read Primitive 0 
readLine() 
readQ 

EOFException 

returns null 

returns -1 

java.io.BufferedReader 

readLine() 
readQ 

returns null 

returns -1 


In the following example we demonstrate detecting EOF with the standard Java class BufferedReader. The 
program simply opens the file specified on the command line and echoes its contents to the console. 

// Echo. java - echo file contents to the screen 
import java.io.*; 
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class Echo { 

public static void main(String[] args) throws IOException { 
if (args.length < 1){ 

System.out.println("Usage: java Echo filename"); 

System.exit(0); 

} 

BufferedReader input = new BufferedReader(new FileReader(args[0])); 

String line = input.readLine(); 
while (line != null) { 

System.out.println(1ine); 
line = input.readLine(); 

} 

} 

} 

Unfortunately the class BufferedReader does not have a constructor that takes a Stri ng as a file name. You 
must first create a Fi 1 eReader and then use this Fi 1 eReader object to create the BufferedReader. 
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10.8 SERIALIZATION AND WRITING OBJECTS 


Serialization is the process of taking one or more values in a Java program and turning them into a sequence 
of bytes suitable for storage in a file system or transmission over a network. Serialization of primitive values 
is simple and can be done with a DataOutputStream. Serialization of objects is only slightly more complex. 

Not all objects can be serialized. For example, you can’t serialize an instance of one of Java’s I/O classes such 
as Pri ntWri ter. If you could, then that would mean you could create a Pri ntWri ter, do some printing to it, 
serialize it to disk, and then later read it back in from disk and continue writing. Although this is doable in 
theory, it is not something that is supported. 

Most objects that can be serialized, can be serialized using the built-in classes for reading and writing 
objects, ObjectlnputStream and ObjectOutputStream from the package java.io. The following example 
shows that essentially all you need to do is have your class implement the interface Seri al i zabl e. That 
interface acts as a flag indicating that the class can be serialized. There are no methods in the interface 
Seri al i zable. This example consists of three classes. MyObject is a sample user defined class that will be 
serialized. It contains fields of other objects and an array to show that these will be automatically serialized 
as well. Seri al i zeOut is a test program that creates a MyObject instance, sets some values for it and then 
writes it to a file. Seri al izeln reads the file created by Serial i zeOut showing that the MyObject instance 
was successfully reconstructed from the file. 

//MyObject.java - sample serializable class 
class MyObject implements java.io.Serializable { 
int[] someArray; 

StringBuffer sbuf, other; 

MyObject(int size, String s) { 
someArray = new int[size]; 
sbuf = new StringBuffer(s); 

} 


public String toStringO { 

StringBuffer result = new StringBuffer(); 
result.appendC'someArray = ") ; 
for (int i : someArray) { 
result.append(i + " "); 

} 

result„append(", sbuf = " + sbuf + ", other = " + other); 
return result.toStringO; 
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// This method is NOT required. 

private void writeObject(java.io.ObjectOutputStream out) 
throws java.io.IOException 

{ 

System.out.println("Writing"); 
out.defaultWriteObject(); 

} 

// This method is NOT required. 

private void readObject(java.io.ObjectlnputStream in) 
throws java.io.IOException, ClassNotFoundException 

{ 

System.out.println("reading”); 
in.defaultReadObj ect(); 

} 

} 

//SerializeOut.java - dumps a MyObject to a file 
import java.io.*; 

class SerializeOut { 

public static void main(String[] args) throws IOException { 

MyObject obj = new MyObject(2, "abc”); 
obj.someArray[0] = 10; 
obj.someArray[1] = 20; 

ObjectOutputStream out = 

new ObjectOutputStream(new FileOutputStream(args[0])); 
obj.other = obj.sbuf; 
out.writeObject(obj); 
obj.other.append( M more"); 

System.out.println(obj); 

} 

} 

//Serializeln.java - reads a MyObject from a file 
import java.io.*; 

class Serializeln { 

public static void main(String[] args) 

throws IOException, ClassNotFoundException 

{ 

ObjectlnputStream in = 

new ObjectInputStream(new FileInputStream(args[0])); 

MyObject obj = (MyObject)in. readObjectO ; 

System.out.println(obj); 
obj.other.append(" more"); 

System.out.println(obj); 

} 

} 

It is important to observe that the reconstructed MyObject in Seri al i zeln has the fields other and sbuf 
both pointing at the same Stri ngBuffer object. The ObjectOutputStream and ObjectlnputStream pre¬ 
serve this sharing of references. This means that you can safely use these classes for serializing even com¬ 
plex data structures such as graphs. 
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Dissection of MyObjectJava 


% class MyObject implements java.io.Serializable { 

In most cases, all you need to do to be able to read and write your objects with ObjectlnputStream and 
ObjectOutputStream, is have your class implement the interface Serializable. There are no required 
methods. 

# int[] someArray; 

StringBuffer sbuf, other; 

MyObjectfint size, String s) { 

someArray = new int[size]; 
sbuf = new StringBuffer(s); 

} 

To demonstrate the automatic recursive serialization of fields, we have included an array and two 
Stri ngBuffer fields in this class. 

# public String toStringO { 

StringBuffer result = new StringBuffer(); 
result .appendC’someArray = "); 
for (int i : someArray) { 
result.append(i + " "); 

} 

result.append(", sbuf = M + sbuf + ", other = M + other); 
return result.toString(); 

} - 

This is a standard toStri ng () method dumping all of the fields of the object. 

# // This method is NOT required. 

private void writeObject(java.io.ObjectOutputStream out) 
throws java.io.IOException 

{ 

System.out.println("Writing"); 
out.defaultWriteObjectC); 

} 

Like the comment says, this method is not required. It is included to show you how to include special 
processing during serialization if required. Notice the unusal type signature for this method. It is 
declared to be private, yet it is never called from within this class. The call to defaul tWri teObject () 
invokes the standard serialization code - what you get if you don’t provide a wri teObject() method 
yourself. 

# // This method is NOT required. 

private void readObject(java.io.ObjectlnputStream in) 
throws java.io.IOException, ClassNotFoundExcept!on 

{ 

System.out.println("reading"); 
in.defau11ReadObj ect(); 

} 

As with wri teOb j ect (), this method is not required. It is here to show how you can intervene in the 
reading of a serialized object if necessary. 
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10.9 PROGRAMMING STYLE 


Although GUI-based programs currently dominate much of computing, many programs are still invoked 
from a command line such as a Windows or Unix command line interpreter, also called a shell These pro¬ 
grams typically have one or more parameters that are specified on the command line. Remembering the 
exact sequence or names of some parameters is often difficult. GUI-based programs often have a help button 
or menu item that can be helpful to a user. Command line-based programs can also provide online help. A 
standard way of providing minimal help is a default help message that’s printed when no command line 
arguments are specified. By convention this message takes the form 

Usage:programName argl arg2 ... 

This message may be followed by a detailed explanation of the arguments or entry into an o nlin e help facil¬ 
ity. For any Java programs that use command line arguments, you should follow this convention. Very early 
in the program, the size of the args array passed to mai n() should be checked. If the array isn’t the right 
length, the usage message should be printed. 

Also by convention, command line arguments beginning with a dash are optional arguments. Combining sev¬ 
eral of these optional arguments is often possible. A common type of online help is to have a command line 
argument -hel p or -h, indicating that an extended help message should be printed out—or, if available, an 
interactive online help facility should be invoked. You can easily check for arguments that begin with a dash 
by using 

if (args[i].charAt(0) == ... 

Building online help facilities into your command line-based programs can make them much more user 
friendly. 



Summary 


# A file is a sequence of text or binary data that is typically accessed sequentially. A Java stream is a 
sequence of bytes. An input stream may be coming from a file, from keystrokes at the console, or from a 
network. Likewise, an output stream may be going into a file, to the console screen, or out over a net¬ 
work. 

• You can use the class Pri ntWri ter from the package java, i o to write text to a file. The primary meth¬ 
ods in the class Pri ntWri ter are the familiar pri nt() and pri ntl n(). 

# You can use the familiar Scanner class to read from a file by passing the constructor for Scanner a ref¬ 
erence to an instance of java. i o. Fi 1 e. The Fi 1 e object can be constructed from a string representing 
the name of the file. 

• The Scanner class can be used to parse strings. You can also change the delimiter used to separate the 
tokens recognized by a Scanner object. 

# Beginning with Java 5.0, you can format text output using the method pri ntf () in the Pri ntStream and 
Pri ntWri ter classes. 

• The pri ntf () method is an example of a method that accepts a variable number of arguments. 
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# An important source of security for files is encryption. In encryption, ordinary text, called clear text, is 
transformed to apparently meaningless characters. Typically, encryption involves the use of an algo¬ 
rithm called a cipher. 

# The two classes DatalnputStream and DataOutputStream can be used to read and write binary files. 
These classes provide methods for reading and writing strings and all primitive types. 

# There are two primary approaches to detecting the end of file (EOF) when reading data. If a distinguished 
value is available, such as nul 1 for re ad Li ne(), then EOF is signaled by having the method return the 
distinguished value. If no distinguished value is available—-that is, all values are legal values—then EOF is 
signaled by throwing an EOFExcepti on. 

f> Many, if not most, Java objects can be serialized - that is, they can be converted to a stream of bytes. 
These bytes can then be stored in a file or sent across a network. Java provides support for this with the 
ObjectlnputStream and ObjectOutputStream classes from the package java. io. 



Review Questions 


1. What two major file divisions were discussed in this chapter? Give an example of each. 

2. To what type of object does Consol e. i n refer? 

3. What is a Caesar cipher? How can a Caesar cipher be broken? 

4. What is a Vignere cipher? Why is a Vignere cipher harder to break than a Caesar cipher? 

5. A Vemam cipher is better known as a_. 

6. What cipher discussed in this chapter is provably unbreakable? 

7. What method can be used to capitalize alphabetic characters? 

8. How is EOF detected when numbers are being read with the class Readlnput? 

9. How is EOF detected when numbers are being read with the class DatalnputStream? 

10. In general, which results in a more compact representation of numeric data: a text file or a binary file? 

11. True or false? The method readlnt() from the class DatalnputStream can be used to read integers 
from the keyboard if you construct a DatalnputStream from System. i n. 

12. Give a Java expression, without using method calls, that converts an uppercase letter to its lowercase 
equivalent. 

13. When you use writelntO from DataOutputStream, how many bytes are written for the value 
123456789? How many bytes are written for the same value if you use pri ntl n() from Pri ntWri ter? 

14. What method from which class can be used to read strings from a binary file? 

15. If the file someData already exists and you open the file for writing with new Pri ntWri ter (new Fi 1 e- 
Wri ter ("someData")), what happens? Are the data in the file overwritten? Or are new data added to 
the end of the file? 














320 


Reading and Writing Files 



Exercises 


1. Write an array of strings to a file named strings.txt. Initialize the array with the four strings "I am", "a 
text”, "file written", and "to strings.txt". 

2. Create an array of strings and fill it with values by reading them from the console using method read- 
Li ne() from java. io. BufferedReader. Write the array to save.txt Specify the number of strings by 
asking the user to enter the number of lines to be read. 

3. Redo Exercise 2 to end when the input is a special sentinel character. For example, you may use an empty 
string as the sentinel. You need not save all the input as an array of strings. You can use a single St ri ng 
variable to receive each line in turn. 

4. Write a program that prints 1000 random numbers to a file. 

5. Write a program to read 1000 random numbers from a file (see Exercise 4) and plot their distribution. 
That is, divide the interval 0-1 into tenths and count the numbers that fall into each tenth. 

6. Modify Exercises 4 and 5 to allow the user to specify the number of random numbers and the name of 
the file on the command line. Store the number of numbers as the first item in the output file. 

7. Redo Exercise 6 without storing the number of numbers as the first entry in the file. Use hasNextDou- 
bl e() in the class Scanner to detect the end of the input file. 

8. Redo Exercise 6, using wri teDoubleQ and readDouble() from DataOutputStream and Datalnput- 
Stream, respectively. 

9. Read a text file and write it to a target text file, changing all lowercase to uppercase and double spacing 
the output text. Use Stri ng and Stri ngBuffer variables ior internal manipulations. 

10. Write a program that reads the bytes of a file one at a time with read (), which is a method in every input 
stream inh erited from InputStream. You can open an input stream from a file with the expression 
new Fi 1 eInputStream("fi 1 ename"). Use System.out.pri ntl n() to print the bytes, placing 4 bytes 
on each output line. Print the bytes in hexadecimal, padding with zeros so that each byte is represented 
by two digits. The hexadecmal digits are 0-9 and a-f. You can get the hexadecimal string representation 
of an i nt value x by using Integer. toHexStri ng(x). Try running this program on a text file and then 
on a binary file. Try it on several class files created by compiling some Java source files. Do you notice 
anything about the first 2 bytes of those files? 

11. Modify the program in the previous exercise to also print the character value of any bytes in the range 32 
to 126, inclusive. Print the characters on the same line separated by a few spaces—for example, 


4578616d 

Exam 

706C6521 

pie! 


12. Create a class Tab! e that represents a table of floating point values. A table is specified by a two-dimen¬ 
sional array of doubl e values, a one-dimensional array of strings that label the rows, and a one-dimen¬ 
sional array of strings that label the columns. The class contains a constructor and one method, 
pri nt(). The pri nt () method should take one parameter, an OutputStream. The method pri nt C) 
should print the table, nicely formatted to the specified OutputStream. Use the pri ntf () to format the 
output. Print at most two digits to the right of the decimal point for the values in the table. 

13. Locate and read the documentation for java, text. Number Format. Construct a Number Format object 
with a pattern for monetary amounts. For example, in the United States, 12345.67 should be formatted 
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as SI 2,345.67. Use Number Format to modify the table in the previous exercise so that the values in the 
table are formatted as monetary values. 

14. Make up a Vignere code based on the word “APPROXIMATE” as a key. Use it to encrypt a clear text file 
and write it out to the end of the clear text in the same file. 

15. Write a program that reads a text file and computes the relative frequency of each of the letters of the 
alphabet. You can use an array of length 26 to store the number of occurrences of each letter. You can 
use Character. i sLetter () to test for letters and then Character. toLowerCaseO to convert all let¬ 
ters to lowercase. Subtracting 1 a r will then give you a value in the range 0 to 25, inclusive, which you can 
use to index into the array of counts. 

16. Run the program from the previous exercise on several large text files and compare the results. How can 
you use this information to break a Caesar cipher? 

17. Modify the class VernamCi pher in Section 10.5, Problem Solving: Encrypting Text Files , on page 310, to 
allow the user to specify the key as a third, optional command line argument. If none is specified on the 
command line, prompt the user to enter the seed at the terminal. This seed is the key needed to decode 
the encrypted file. 

18. Write a program to decode the results of encoding a file using the VernamCi pher program in Section 
10.5, Problem Solving: Encrypting Text Files, on page 310. You will need to use the same seed for encod¬ 
ing and decoding. What happens if you insert one extra character or drop one character from the 
encrypted file? 

19. Write a program that tests whether a file exists. It should read the file name from the console and then 
print “exists” or “doesn’t exist.” The class Fi le in the standard package java, io contains a method 
exi sts(). 

20. Write a program with a GUI that reads text one line at a time from a designated file and displays the line 
ina JTextField. The file name should be placed in a text window and a button event used to open it. 
There should be a button for signaling that you want the next line. 

21. Alter the program in the previous exercise to include a designated named output file. The text line 
should be modifiable and the modified text should be sent to the output file. Note how this is the begin¬ 
ning of an editor program. 

22. A JTextArea component is like a JTextFi eld, but it can display multiple lines. In Section C.6, The Class 
JTextArea , on page 438 we show how to use a JTextArea. Use a JTextArea component to create a sim¬ 
ple editor. Allow the user to enter and edit text, save the text to a file, and specify a file for editing. 
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“To err is human" (Alexander Pope, 1/17). 


With very few exceptions most software contains defects produced by human error. Some defects are 
detected and removed during software development. Some defects result in program failures when the “com¬ 
pleted” software is used, and some defects may go undetected. 

In this chapter we will discuss four different strategies for de aling with software defects. We will begin by 
describing Java’s exception handling mechanism. The Java exception handling mechanism makes it possible 
to design programs to “catch” certain types of unexpected conditions that occur during program execution 
and take remedial action. Th,ese unexpected conditions could be due to erroneous input, or failures in one 
part of a program that can be dealt with thus preventing the entire program from f ailing Such unexpected 
conditions are called exceptions. 


Exception handling mechanisms allow a program to recover and continue when one part of the code does 
something erroneous. Better still would be to design the code to not exhibit the erroneous behavior in the 
first place. This is generally handled using testing which is the second major topic of this chapter. Although 
formal proofs of correctness have been pursued for many years, such techniques are still largely a research 
topic, leaving testing as one of the primary mechanisms for ensuring software quality. 


Testing involes providing some input to a program or method and observing the results to see if they are as 
expected. Test case generation is often done as a separate process from coding. A complimentary process to 
the development of external testing is to build a form of testing right into the code. These built in tests are 
called assertions. Java has a keyword, assert, that can be used to insert tests directly into the code that 
remain part of the source. When an assertion fails it throws an exception. 

Once a defect has been detected either as a result of testing or as the result of some failure during use, it is 
still necessary to locate the cause of the defect. This can be a very difficult and time consuming process. A 
debugger is a tool that can aid in the process, allowing a programmer to control the execution of a program 
and observe the internal state of the program as it executes. In the last section of this chapter we will discuss 
debugging and give an introduction to debuggging using the standard Java debugging tool, jdb. 
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Coping with Errors 



11.1 EXCEPTIONS 


Until now, we have viewed an exception as an error that resulted in the program being terminated. However, 

there are many kinds of exceptions, sometimes the program doesn t need to be terminated. Some exceptions 
that we have discussed in previous chapters are 

• ArraylndexOutOf Bounds— when an array index is less than zero or too big; 


• Nu11 Poi n ter Except! on— when an attempt is made to call a method or access a field of an object using 
a reference that is null ; and 

A ri thmeticExcept! on—results from attempting to divide by zero. 


11-1-1 EXCEPTION HANDLING-WITH try AND catch 

A robust program deals gracetnlly with unexpected input. For example, when asking a user to enter numeric 
data in a certain range, a robust program determines whether the data are numeric and within range. If the 
data aren’t numeric or are out of range, some appropriate action, such as asking the user to reenter the data, 
should be taken. In general, this type of run-time error checking can be done with the basic control flow con¬ 
structs from Chapter 3, Statements and Control Flow; however, doing so can be cumbersome. 

Suppose that we want to prompt the user for an integer, read it in, and do the checking suggested. Here is 
how we currently read in an integer. 

Scanner Input - new Scanner(System.in); 

• ■ ■ 

int myData = input.nextlntO; 

In order to make this procedure robust, we need some mechanism for indicating that the next sequence of 

characters in the input stream doesn’t constitute a valid integer. One option would be to modify the method 

nextlntO to take a status parameter. Because the parameter would need to be modified by nextlntO, we 

need to pass a reference to an object that contains a bool ean. We can do so by using the following trivial 
class. 

class Status { 
boolean f1ag; 

} 

By using true to indicate success and fal se to indicate failure, we could check the value of the status 
parameter with 

//nextlntO Isn't defined to work this way 
Status status = new StatusO; 

Int myData = input.nextlnt(status); //hypothetical 
If (!status.flag) { 

// put error handling code here 

} 

However, there are some problems with this approach. We needed to add an extra parameter to the method 
nextlntO, declare the status variable in our code, and then test status. More important, we needed to 
test the value, even though we expect that status will always be true. So, under normal conditions, the time 
needed to set and test the status variable is wasted time. To add to the complexity of this approach, the pre¬ 
ceding code may be inside another method that doesn’t know how to handle the error case. In this situation, 
we also have to add a status parameter to the enclosing method. Then the error h andlin g code simply sets 
the status parameter passed to it to be f al se and returns as shown in the following code. 
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ILL! Exception Handling with try and catch 

int processInput(..., Status status) { 

■ m m 

//nextlntO isn’t defined to work this way 
int myData = input.nextlnt(status); 
if (!status.flag) { 

// have to return something 
return 0; // assume return value will be ignored 

} 

// go on with normal processing 

■ * 9 

} 

Progr amin g language designers recognized this pattern of returning status values that are then tested. They 
realized that they could clean up such programs by providing a special mechanism for this procedure. The 
mechanism is called exception handling . 

An exception is a condition In a program that is expected to occur only rarely if ever. In the preceding exam¬ 
ple, if the user follows instructions and enters the proper type of data, no exception (think of it as an error) 
will occur. In the exceptional case, when the user fails to follow instructions and types something that isn’t 
an integer, the method trying to read the integer will throw an exception. 

The word throw describes the action of an exception occurring. It may be useful to think of throw as in “to 
throw a special value to the operating system.” Unless the program explicidy does something to recover from 
the exception, the program aborts and displays an error message. 

The word catch describes the construction used to specify what to do when an exception occurs. The pro¬ 
gram specifies some code that is to be executed if an exception occurs, in which case the error is caught and 
prevented from aborting the program. 

A catch includes a block of code for handling the exception type, specified as a parameter, after the keyword 
catch. It occurs immediately after a try block. Syntactically, a try block is a block of code that has the key¬ 
word try as a prefix. The basic layout for catching an exception is 
try { 

// some code here that might throw an exception 

} 

catch ( ExceptionType Identifier ) { 

// some code here to handle the exception 

} 

If any statement in the block following try throws an exception of type ExceptionType , control is immedi¬ 
ately transferred to the code in the block following catch. The rest of the statements in the block with the 
statement throwing the exception are skipped. When the catch block is executed, the variable Identifier refers 
to a type ExceptionType object that describes the exception. 

The first example discussed in this section, when written using exceptions, becomes 

int myData; 
try { 

myData = i nput.nextlntO ; 

} 

catch (InputMismatchException e) { 

// put error handling code here 

} 

The method Scanner. nextlntO throws a InputMi smatchException if the next set of characters in the 
input stream doesn’t constitute a legal integer. If the exception is thrown, no characters from the input 
stream are consumed and myData remains unchanged-the assignment won’t happen. 

If instead the error is going to be handled at a higher level, then we don’t need to do any thin g at the point of 
the call to readlntC). The method processInputQ becomes 
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int processInputQ ..) { 


int myData = i nput. nextlntQ ; 

// go on with normal processing 


Mill 


e- 


In this case, when the exception occurs in nextlntQ— because there is no try block—the exception is i 
diately passed up to the next higher level. That is, as before, the assignment to myData doesn’t occur. In addi¬ 
tion, the method processInputQ returns imm ediately, throwing the same exception thrown by nextlnt(). 
There is no return value because any assig nm ent Involving the value returned from processInputQ also 
doesn’t happen. 


Presumably, in this situation, the exception is caught at a higher level—for example, at the point that pro¬ 
cessInputQ is called. So let’s try this approach, which seems to work better. 


inputReadOK = false; // allow loop to execute once 
while (!inputReadOK) 
try { 

x = processInputQ . .) ; 

} 

catch (InputMismatchException e) { 

System.out.println(e); 

input. nextO; //discard the bad input value 
System.out.printlnQ'Please try again..."); 

} 

inputReadOK = true; // successful input 

} 

// go on with normal processing 

The following code robustly reads one integer from the console. If the user doesn’t type an integer, he or she 
is prompted to try again. 

// ExceptionExample.java - catch an exception 

import java.util.*; 

public class ExceptionExample { 

public static void main(String[] args) { 

Scanner input = new Scanner(System.in); 
int aNumber = 0; 
boolean success = false; 

System, out. pri ntl nQType an integer."); 
while Qsuccess) { 
try { 

aNumber = input.nextlntQ ; 
success = true; 

} 

catch (InputMismatchException e) { 

String inputstring = input.nextQ; 

System.out.println(inputString + " is not an integer. Try again!"); 

} 

} 

System.out.printlnQ'You typed " + aNumber); 

// continue with code to process aNumber 

} 


} 
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Dissection of the Class ExceptionExample 

while (!success) { 

This loop continues until the assignment success = true is executed 


try { 
aNumber 
success 

} 


= input.nextlnt(); 
= true; 


If an InputMi smatchExcepti on occurs while any statement in the try block is being executed, control 
is immediately transferred to the first statement in the catch block. In this case, the call to nextlntQ 
may throw a InputMi smatchExcepti on, in which case aNumber remains unchanged and the subsequent 
assignment success = true won’t execute; hence the while loop repeats. 


j| catch (InputMismatchException e) { 

String inputstring = input.nextlnt(); 
System.out.println(inputString + " is 

} 


not an integer. Try again!”); 


In this example we ignore the parameter. Having arrived at this catch block tells us all we need to 
know—an InputMi smatchExcepti on occurred in the previous try block. Because nextlntO is defined 
not to consume any input characters if it fails, we use next() to read the offending white-space delim¬ 
ited string of characters. We print an appropriate message and then continue with the statement follow¬ 
ing the try-catch statement. The exception has been handled and normal execution resumes. 

while (Isuccess) { 



success = true; 


} 


System.out.println(”You typed " + aNumber); 
// continue with code to process aNumber 


Eventually the user will type a legal integer. At that time the assignment to success is reached, the end 
of the try block is reached, the catch block is skipped, and the loop exits. 
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Common Programming Error 

Failure to verify that data were correctly entered is a common programming error. In robust programs 
input should be tested to determine whether it is both syntactically and semantically correct. Frequently, 
good practice is to ask the user to confirm the value entered. The following loop does just that. 

while (Iconfi rm. equals("Y")) { 

//...ask for data in dollars 

System.out.println("Did you mean " + dollars); 

System.out.println("Please Enter Y or N:"); 
confirm = input.next(); 

} 

This technique can be combined with the exception handling methodology of the preceding example. 
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1 1.1,2 CATCHING AN EOFException 

As discussed In the Section 10.7, Detecting the End of an Input Stream , on page 313, sometimes an exception 
is used to detect the end of a file. For the standard Java class java . i o . DatalnputSt ream, when primitive 
values are being read, no special value can be returned to indicate the end of the file has been reached. 
Instead, an exception is thrown. 

Java methods have throws clauses that indicate some exceptions that can happen while executing the 
method. Such exceptions are known as checked exceptions. There are also run-time exceptions, such as 
divide-by-zero, which are unchecked . A checked exception must have a corresponding catch to handle it or 
be declared in a throws clause; otherwise, you have a syntax error. 

The following program reads integers from a binary file and prints them to the screen. Recall that a binary 
file doesn’t store the individual characters that make up the number. Instead, the file stores the bytes that 
correspond to the binary representation of the number. Storage of each integer value uses 4 bytes. You can’t 
view the files read by this program with a normal text editor. 

// Binarylnput.java - read some integers from a binary file 
import java.io.*; 

class Binarylnput { 

public static void main(String[] args) throws IOException 

{ 

DatalnputStream input = null; 
if (args.length ! = 1) { 

System.out.println("Usage: " + "java Binarylnput filename"); 

System.exit(l); 

} 

try { 

input = new DataInputStream(new Fi1eInputStream(args[0])); 

} 

catch (IOException e) { 

System.out.println("Could not open " + args[0]); 

System.out.println(e); 

System.exit(l); 

} 

// count is used to print 4 values per line 
int count = 0; 
try. { 

while (true) { 

int myData = input. readlntO ; 
count++; 

System.out.print(myData + " "); 

// print a newline every 4th value 
if (count % 4 -= 0) 

System.out.println(); 

} 

} 

catch (EOFException e) 

{ 

// just catch the exception and discard it 

} 

// add a newline after the last partial line if necessary 
if (count % 4 != 0) 

Systern.out.println(); 

} 

} 
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Dissect ion of the Class Binarylnput 


import java.io.*; 
class Binarylnput { 

public static void main(String[] args) throws lOException 

{ 

DatalnputStream input = null; 
if (args.length != 1) { 

System.out.println("Usage: ” + "java Binarylnput filename 1 '); 

System.exit(l); 

} 

The user is expected to supply the name of the input file on the command line. If no file name is pro¬ 
vided, a message is printed to remind the user how to utilize this program. The throws clause indicates 
that IOExcepti on is a checked exception that needs to be caught. 

• try { 

input = new DataInputStream(new FileInputStream(args[0])); 

} 

catch (lOException e) { 

System.out.println("Could not open ” + args[0]); 

System.out.println(e); 

System.exit(l); 

} 

We don’t need to catch this exception, but by catching it, we can print a clear message to the user. For 
instructional purposes we also print out the actual exception. In a real program we probably wouldn’t 
include the second println(). 

• int count = 0; 
try { 

while (true) { 

int myData = input. readlntQ ; 
count++; 

System.out.print(myData + " "); 

// print a newline every 4th value 
if (count % 4 Mk 0) 

System.out.println(); 

} 

} 

catch (EOFException e) { 

// just catch the exception and discard it 

} 

The reading is done inside a try-catch statement. Note that, at first glance, the loop appears to loop 
forever. However, the loop is exited when the input, readlnt () call throws an EOFExcepti on. At that 
point, control is passed to the catch block. In this case there is nothing to do: There is no error, and we 
don’t want to print anything. We just continue with normal processing. 

• if (count % 4 != 0) 

System.out.printlnQ; 

After execution of the try block has been completed, execution continues with this statement. It is used 
to add a newline in case the last line contains less than four numbers. 
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To test the preceding program we need a sample input binary file. We can use the following program to gen¬ 
erate a sample input file for Bi narylnput. It writes 10 integers using a DataOutputStream. You won’t be 
able to view the contents of the file generated by the following program with a normal text editor. 

// BinaryOutput.java - create a sample binary file 
import java.io.*; 
class BinaryOutput { 

public static void main(String[] args) throws IOException { 

DataOutputStream output = null; 
if (args.length != 1) { 

System.out.println("Usage: " + "java BinaryOutput filename"); 

System.exit(l); 

} 

try { 

output = new DataOutputStream(new FileOutputStream(args[0])); 

} 

catch (IOException e) { 

System.out.println("Could not open " + args[0]); 

System.out.println(e); 

System.exit(1); 

} 

for (i nt i = 1; i <= 10; i++) 
output,writelnt(i * 100); 

} 

} 

The output of Bi narylnput when executed with the file created by Bi naryOutput is 


100 200 300 400 
500 600 700 800 
900 1000 


11.13 ABRUPT RETURN FROM METHODS THAT THROW EXCEPTIONS 

As indicated in Section 11 1.2, Catching an EOFException , on page 328, when an exception occurs in a method 
without a try block, the method returns immediately. There is no return value, and the rest of the state¬ 
ments in the method are ignored, as shown in the following program. 

// ExceptionExampleTwo.java - show control flow when 
// an exception occurs during nested method calls 
import java.util.Scanner; 

class ExceptionExampleTwo { 

static Scanner input = new Scanner(System.in); 
public static void main(String[] args) { 
i nt x = 0; 

System.out.println("main starting"); 
try { 

x = cal 1 One(); 

System.out.println("calIGne OK x = " + x); 

} 

catch (ArithmeticException e) { 

System.out.println("callOne not OK: " +e+ "\nx = "+x); 
e.printStackTrace(); 
x = -1; 

} 

System.out.println(”main exiting x - " + x); 

} 
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static int call One() { 

System.out.println("cal 1 One starting"); 
int result = callTwoO; 

System.out.println("callOne returning result = " + result); 
return result; 

} 

static int callTwoQ { 
int num = 0; 

System.out.println("type a number"); 
int somelnt = input.nextlntQ ; 
num = 1000 / somelnt; 

System.out.println("calITwo returning num = " + num); 
return num; 

} 

} 

If we run the program and use the input value of 10, we get the “normal” execution output shown 


os-prompt>java ExceptionExampleTwo 
main starting 
callOne starting 
type a number 
10 

callTwo returning num = 100 
callOne returning result = 100 
call One OK x = 100 
main exiting x = 100 
os-prompt> 


If we run the program and use the input value 0, we get the “exceptional” execution output shown. 


os-prompt>java ExceptionExampleTwo 
main starting 
callOne starting 
type a number 
0 

callOne not OK: java.lang.ArithmeticException: / by zero 

main exiting x = -1 

os-prompt> 


The string java.lang.ArithmeticException: / by zero results from the method toStri ng() of the 
exception object referred to by e, the parameter passed to the catch block. Note that the last pri ntl n() calls 
in both cal 10ne() and cal ITwoQ weren’t executed. Those methods both terminated abruptly. Because the 
exception wasn’t caught in cal ITwoQ, the method terminated abruptly, throwing the same exception 
thrown by the attempt to divide by zero. likewise, cal 10ne() doesn’t catch the exception consequently 
thrown by the call to cal ITwoO, so call One () also terminates abruptly, again throwing the same exception. 
Finally, the exception is caught in mai n (). 


1 1.1.4 CATCHING SEVERAL DIFFERENT EXCEPTIONS 

We can have several different catch blocks in a single try-catch statement. For example, suppose that we 
wanted to let the program Excepti onExampl e in Section 11.1.1, Exception Handling with try and catch , on 
page 326, continue with the default value of 0 for the variable aNumber if there is no more input. The method 
nextlntC) throws aNoSuchElementException if it encounters the end-of-file before reading a number. On 
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most systems we can signal the end of input from the keyboard by typing either Ctrl+D or Ctrl+Z. We add 
this capability to Excepti onExampl e as follows. 

// TwoCatchExample.java - use two catch clauses 
import java.util.*; 

public class TwoCatchExample { 

public static void main(String[] args) { 

Scanner input = new Scanner(System.in); 
int aNumber = 0; 
boolean success = false; 

System.out.println("Type an integer.”); 
while (isuccess) { 
try { 

aNumber = i nput. nextlntQ ; 
success = true; 

System.out.println("You typed ” + aNumber); 

} 

catch (InputMismatchException exception) { 

String inputstring = input.next(); 

System.out.println(inputString + ” is not an integer. Try again!”); 

} 

catch (NoSuchElementException exception) { 

System.out.println(”Continuing with default value 0.”); 
aNumber = 0; 
success = true; 

} 

} 

// continue with code to process a_number 

} 

} 

Note that we added a second catch block. If no exceptions occur during the try block, then both catch 
blocks are skipped and execution proceeds normally, following the last catch block. If an exception does 
occur, the first catch block that specifies an exception type that either matches the exception or is a super 
class of the exception type that was thrown, will be executed. When the catch block is finished, execution 
continues normally with the statement following the last catch block. At most, one of the catch blocks will 
be executed. 

If one of the exception types that you’re trying to catch is a superclass of another that you’re also trying to 
catch, the one that is a superclass must be listed last. Otherwise, the more specific catch block is never exe¬ 
cuted. 

Suppose that Excepti onSu per and Excepti onSub are two exception classes, where Excepti on Sub is a sub¬ 
class of Excepti onSuper. The following try block would be incorrect. 

try { 

m m m 

} 

catch(ExceptionSuper e) { 

■ • * 

} 

catch(ExceptionSub e) { 

■ * ■ 

} 

Luckily, the Java compiler will detect thi s error and report it with a message something like 
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Filename.java:100: exception ExceptionSub has already been caught 
catch(ExceptionSub e) { 

A 

Putting the catch blocks in the other order in the previous example would be fine. 


ILLS THE finally CLAUSE 

Java provides a f i nal 1 y clause of a t ry block as code that is always executed whether or not an exception is 
thrown. This code is sometimes referred to as cleanup code . It is most often used to release special 
resources, such as open files, back to the system. 

The following class, Bi narylnput2, is a redesigned version of the class Bi narylnput. It provides a class 
method, readBinarylnputC), that reads integers from a binary file and prints them to the screen. This 
method is very 7 similar to the method mai n () in the class Bi narylnput. The most significant change is the 
addition of a f i nal 1 y clause that does some last bit of clean up. Namely, it makes sure that a final newline is 
written and that the appropriate open file is closed. Presumably, some other class would make a call to 
Bi narylnput2. readBi narylnput (), passing it the name of the binary file from which to read and the num¬ 
ber of integers to read from the file. 

// Binarylnput2.java - read some integers from a binary file 
import java.io.*; 

class Binarylnput2 { 

public static int readBinarylnput(String filename, int howMany) 
throws IOException 

{ 

DatalnputStream input = null; 
try { 

input = new DataInputStream(new FilelnputStream(filename)); 

} 

catch (IOException e) { 

System.out.println("Could not open " 4-filename); 

System.out.printlh(e); 
throw e; 

} 

int count = 0; 
try { 

while (count < howMany) { 

int myData = input. readlntQ ; 

count+4-; 

System.out.print(myData + " "); 

// print a newline every 4th value 
if (count % 4 == 0) 

System.out.printlnO ; 

} 

} 

catch (EOFException e) { 

// just catch the exception and discard it 

} 

finally { 

if (count % 4 !- 0) 

System.out.printlnO ; 
if (input != null) 
input.close(); 

} 

return count; 

} 


} 
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Dissection of the Class Binarylnput2 

# class Binarylnput2 { 

public static int readBinarylnput(String filename, int howMany) 
throws IOException 

This class contains the single method readBi narylnput (). In addition to the file name, we pass in the 
number of integers to read. The method reads howMany integers or until the end*of-file is reached. The 
method returns the number of integers actually read and printed. 

f> DatalnputStream input = null; 
try { 

input = new DataInputStream(new FilelnputStream(filename)); 

} 

catch (IOException e) { 

System.out.println("Could not open " +filename); 

System.out.println(e); 
throw e; 

} 

In Bi narylnput .mai n(), we called System, exi t() after catching an exception while trying to open the 
file. In this version, we print the error message as before, but instead of aborting the entire program, we 
pass the exception to the calling environment by retlirowing the exception we just caught. The method 
calling Bi narylnput2 .readBi narylnput() can either catch the exception or let the program abort. 

int count = 0; 
try { 

while (count < howMany) { 

int myData = i nput. readlntQ ; 
count++; 

System.out.print(myData + " "); 

// print a newline every 4th value 
if (count % 4 == 0) 

System.out.println(); 

} 



} 

catch (EOFException e) { 

// just catch the exception and discard 

} 


it 


m 


We changed the loop so that it reads at most howMany integers. Unlike the earlier version, this loop can 
either exit normally or exit as the result of an EOFException. 

m finally { 

if (count % 4 != 0) 

System.out.println(); 
if (input ! = null) 
input.close(); 

} 

The code in this fi nal 1 y block will be executed no matter how the try block exits. If the try block exits 
because of an EOFExcepti on, then the fi nal 1 y clause executes after the catch, which is empty in this 
example. If the try block exits normally because the whi 1 e loop terminates, the fi nal 1 y clause exe¬ 
cutes before continuing and executing the final return statement. If the try block exits because of some 
uncaught exception, the finally clause still executes before the method is terminated abruptly and the 
exception is thrown to the calling method. Note that this last case makes the code behave differently 
than it would if we simply placed the statements in the fi nal 1 y block, immediately after the try-catch 
statement, without using f i nal 1 y. 
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• return count; 

This statement is executed after the code in the fi nal 1 y clause. This statement is executed if the loop 
terminates normally or if an EOFExcepti on is thrown. This statement won’t be executed if some other 
exception happens during execution of the previous try-catch statement. 
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11.1.6 PROGRAM CORRECTNESS: THROWING AN EXCEPTION 

In the constructor for the class Counter in Section 6 . 8 , Constructor Methods and Object Creation, on page 
168, we used the modulus operator to guarantee that the value field of the constructor was initialized to a 
value consistent with the description of the class. This approach could lead to an error in a program that 
would be hard to detect. Suppose that we had forgotten that the class Counter was defined to wrap around 
at 100 and instead thought it would wrap around at 1000—or not wrap at all. We might then decide to con¬ 
struct a Counter value starting at 200, as in 

Counter bigCounter = new Counter(200); 

Depending on how we used this Counter object, our misunderstanding might go undetected until the pro¬ 
gram containing this code was in use, possibly in a crucial situation. 

An alternative definition of the constructor for Counter could notify the caller when an invalid parameter is 
passed to the constructor. The technique used in Java to send such a notification is to throw an exception. In 
the preceding sections we introduced exception handling, which is how the caller detects and attempts to 
handle an exceptional condition. The following modified constructor for the class Counter throws an excep¬ 
tion when an attempt is made to initialize the Counter with an invalid value. 

public class Counter { 

//constructors 
public CounterO {} 
public Counter(int v) { 
if (v < 0 || v >= 100) 

throw new Exception(”Invalid initial value."); 
el se 

value = v; 

} 


} 

Using this modified version of the class Counter, our attempt to construct a Counter using 200 would fail 
the first time it was executed. In this way, any test of the program that executes the assignment to bi g- 
Counter would generate an exception, allowing for the error to be detected early in the development pro¬ 
cess. 

The test i f (v < 0 | | v >= 100) is called a precondition because it determines whether the input is suit¬ 
able, that is, allows the constructor or method to work correctly. Similarly, tests can be added at the end of a 
method or constructor to determine whether certain conditions have been established. Such a test is called a 
postcondition because it tests a relationship that must hold if the method did its work correctly. 

As methods become longer and more complicated, the use of preconditions and postconditions—also called 
assertions— becomes even more important. They are easy to write, add robustness to code, and help other 
readers of the code understand its intent. Java provides direct support for assertions with the keyword 
assert, as discussed in Section 11.3, Assertions, on page 342. 
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1 1.1.7 RuntimeExceptions AND THE throws CLAUSE 

You may have noted that sometimes we used a throws clause when defining methods that might throw an 
exception. For example, in Section 10.2, Writing Text Files, on page 300, we added the clause 

throws java.io.IOException 

to the declaration of the method mai n () because opening a file for writing might encounter some kind of 
problem. At the same time, other methods that might throw exceptions didn’t require a throws clause. For 
example, any time an array is indexed, an IndexOutOfBoundsException can occur, yet we never included 
the clause 

throws IndexOutOfBoundsException 

The designers of Java decided that certain exceptions that might occur “during the normal operation” of Java 
programs didn’t need to be declared. In general, these are exceptions that might occur almost anywhere, 
such as trying to use a reference variable that isn’t referencing any object (Null Poi nterException) or 
indexing an array with an index out of range. These are known as unchecked exceptions. From a practical 
point of view, requiring all such exceptions to be declared with a throws clause would have defeated any 
advantage of its use. All but the most trivial methods would have needed a throws clause with many excep¬ 
tions in it. More than 20 subclasses of Excepti on are defined in the package j ava. 1 ang. 

The designers knew that they couldn’t identify in advance all exceptions that shouldn’t be declared with a 
throws clause. Hence they created an exception class java. lang. Runtime Exception from which all such 
exceptions must be derived. Any exception class that is a subclass of Runti me Excepti on doesn’t need to be 
declared with a throws clause. Any exception class that isn’t a subclass of Runti meException must be han¬ 
dled in the method where it can occur, or the method must declare it, using a throws clause. These are the 
checked exceptions. All exceptions defined In the package java. 1 ang are subclasses of Runti meExcepti on. 

The standard Java input methods throw a java.io. EOFException when they encounter the end-of-file. The 
class java, uti 1 . InputMi smatchException is a subclass of java. lang. Runti meExcepti on, which is why 
we didn’t need to include a throws clause in the program examples in the early chapters of this book that 
used Scanner. 

As a general rule you shouldn’t create new exception classes that are subclasses of Runti meExcepti on. Cre¬ 
ating such exception classes defeats the compile-time checks normally used to notify you that an exception 
might occur. This notification allows you to add exception handling code, making your program more robust. 
As you gain programming experience, you will become increasingly aware of the standard Java exceptions 
derived from Runti meExcepti on and can decide whether you want to add code to handle any of these 
exceptions. 

To create a new type of exception, extend an existing exception class. The reference in a throw statement 
such as 

throw reference 

must be a subclass of the class j ava. 1 ang. Throwabl e. The base of all such throwable classes that represent 
exceptions that a reasonable program might be expected to try and handle is the class java. 1 ang. Excep¬ 
ti on. The class Exception is a subclass of Throwable. The class java. 1 ang . Error is a separate subclass of 
Throwabl e that represents throwable conditions that a reasonable program isn’t expected to be able to han¬ 
dle. Like subclasses of Runti meExcepti on, subclasses of Error don’t need to be declared with a throws 
clause. The following diagram illustrates a partial inheritance hierarchy, showing some of the core throwable 
classes. 
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1 1.2 TESTING 


Edsger Dijkstra, a famous computer scientest, once said, “testing can be used to show the presence of bugs 
but never to show their absence.” Ideally we would like to assert that our program is defect free. Unfortu¬ 
nately proving that a program is free of defects is still an active research area and most programmers have to 
settle for trying to do a good job with testing and other quality assurance methods such as code inspections. 

Entire books have been written about software testing. Testing comes in many flavors: unit testing, integra¬ 
tion testing, functional testing, blackbox testing, branch coverage testing, statement coverage testing, regres¬ 
sion testing, and more. 

In Section 4.9.4, Twenty-one Pickup: Testing , on page 105 we introduced branch coverage and statement cov¬ 
erage as two metrics that could be used to guide the development of a test suite. The idea was to try and cre¬ 
ate a set of input sequences for the program that would exercise every statement or every branch. Although 
this is not sufficent to show a program is free of defects, you certainly won’t discover a defect in a statement 
or branch choice that is not executed by your test suite. 


Unit testing involves writing separate tests for each “unit”. The exact specification of what constitutes a unit 
is up to the project team. A typical unit might be a class or a method, but could also be a larger subset of a 

large program. 


Integration tests are tests designed to be run on the fully integrated system. The tests focus not on testing 
the internals of the various units but instead focus on creating tests that exercise the interfaces between the 

units. 


Functional testing dictates that each test focus on a specific function of the program. For example, try out 
each of the command line parameters or click on each of the menu items in a GUI. 


In blackbox testing, the test writer does not know anything about the internal implementation of the soft¬ 
ware being tested. In contrast, some test writers know about the implementation details of the program and 
use this information to guide the test development. 


Regression testing is used to try and make sure that as new features are added or bugs are fixed, that previ¬ 
ously known “good code” has not been broken. Regression testing is more about the testing process than the 
actual test suite development. The key is to have a sufficiently automated test process that can easily run 
your test suite after any major change in order to make sure you didn’t break something that used to work. 


1 1.2.1 TESTING WITH JUNIT 


The open source pro ject, junit, has developed a framework for writing and running tests for Java programs. 
In the remainder of this section we will show how you can create a suite of tests for two programs used as 
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examples earlier in the text, TwentyOnePi ckup and PredatorPrey. We will not provide complete test suites, 
but only the beginning with enough information to allow you to use junit for testing your own programs. 

In order to use junit you will need to download the junit Jar file from junit.sourceforge.net and install it 
appropriately on your computer. 

A junit test suite is composed of one or more test cases. Junit includes a class TestSui te that is just what it 
says it is, a suite of test cases. The junit class Test Case is shghtly misnamed because it can contain one or 
more test cases. The actual test cases correspond to specially named methods in the TestCase class. The 
best way to see this is to look at a small example test suite. 

// TestTwentyOnePickup.java 
import junit.framework.TestCase; 

public class TestTwentyOnePickup extends TestCase { 
public void testComputerMoveQ { 

assertEquals(20,TwentyOnePickup.computerMove(21)); 
assertEquals(19,TwentyOnePickup.computerMove(20)); 
assertEquals(16,TwentyOnePickup.computerMove(19)); 
assertEquals(16,TwentyOnePickup.computerMove(18)); 

} 


public void testComputerWin() { 

assertEquals(0,TwentyOnePickup.computerMove(3)); 
assertEquals(0,TwentyOnePickup.computerMove(2)); 
assertEquals(0,TwentyOnePickup.computerMove(1)); 

} 

public void testUserMove() { 

// expected input is 4 1 -3 1 0 1 
assertEquals(20, TwentyOnePickup.playerMove(21)); 
assertEquals(20, TwentyOnePickup.playerMove(21)); 
assertEquals(20, TwentyOnePickup.pi ayerMove(21)); 

} 

public void testUserMoveAtEndQ { 

// expected input is 32022 
assertEquals(0, TwentyOnePickup.pi ayerMove(2)); 
assertEquals(0, TwentyOnePickup.pi ayerMove(2)); 
assertEquals(0, TwentyOnePickup.pi ayerMove(2)); 

} 

} 

The simplest way to create a set of test cases using junit is to extend the class junit. f ramework. TestCase. 
We then add publ i c voi d methods that take no arguments and name them starting with “test” as shown in 
this example. 

In this example we have created four test cases. In fact, we could have broken each of the test cases down 
further with only one assert per test case, but it seemed appropriate to group them as suggested by the 
method names. The first method, testComputerMove(), tests to see that we have properly implemented the 
computer move strategy for each of four different consecutive values. 

The second method, testComputerWi n(), makes sure the computer will take the last of the stones if given 
the chance. 

The last two methods test the pi aye rMove () method to make sure that it properly enforces only making 
legal moves. When we run the test cases we will need to provide the indicated input values. 

Each of the test cases uses the method assertEqual s() to test the expected value, which is the first param¬ 
eter, and the actual test value. The method assertEqual s () is inh erited from TestCase. There is no 
assertNotEqual (), but there is an assertFal se() which can be used to assert that two values are differ¬ 
ent. 
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To run this test suite we can use the following program. 

import junit.framework.TestSuite; 
class TestMain { 

public static void main(String[] args) { 

TestSuite suite = new TestSuite(TestTwentyOnePickup.cl ass); 
junit.textui.TestRunner.run(suite); 

} 

} 

The constructor for TestSui te takes as a parameter the class object for the test case class. This is the same 
reference we would get if we used the expression (new TestTwentyOnePi ckupQ) .getClassQ. The 
TestSui te class uses what is called reflection to discover the names of all stati c voi d methods in the class 
that start with test. We could have explicitly added each of the test methods ourself but the reflection feature 
of Java allows TestSuite to find all of the methods for us. 

The method TestRunner. run() will invoke each of the test methods and summarize the results. Because we 
are testing a method that reads from System. i n, we will have the program read the test input from a file. 
Here is the result of running the program on a file containing “4 1 -3 1 0 1 3 2 0 2 2”. 


os-prompt>java TestMain < userlnput.txt 
The computer removes 1 stones leaving 20. 

The computer removes 1 stones leaving 19. 

■ m m 

Your move - how many stones do you wish to remove? 
There are 0 stones remaining. 

Time: 0.15 

OK (4 tests) 


The methods being tested generated some ouput which we ellided to save space. The final result is that all of 
the tests passed. To see what happens when a test fails, we modified getllserMoveO to fail to check that 
there were sufficient stones remaining. Specifically the line 


while ( move > numberOfStones || move < 1 


move > 3 ) { 


was changed to 

while ( move < 1 || move > 3 ) { 


and then we ran the tests again. This time the output is 
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os~prompt>java TestMain < userlnput.txt 
The computer removes 1 stones leaving 20. 

The computer removes 1 stones leaving 19. 

* * 9 

Your move - how many stones do you wish to remove? 

There are -1 stones remaining. 

F 

Time: 0.161 

There was 1 failure: 

1) testUserMoveAtEnd(TestTwentyOnePickup) 
j unit.framework.AssertionFai1edError: 
expected:<0> but was:<-l> 

at TestTwentyOnePickup.testUserMoveAtEnd(TestTwentyOnePickup.java:24) 
at sun.reflect.NativeMethodAccessorlmpl.invoke0(Native Method) 
at sun.reflect.Nati veMethodAccessorlmpl.invoke(Unknown Source) 
at sun.reflect.DelegatingMethodAccessorlmpl.invoke(Unknown Source) 
at TestMain.main(TestMain.java:6) 

FAILURES!!! 

Tests run: 4, Failures: 1, Errors: 0 


From this output we can imm ediately see the name of the test that failed, testUserMoveAtEnd, the expected 
and actual test values, and the line number in the test case where the failure was detected. Junit distin¬ 
guishes between failures and errors. A failure is the result of a failed assertion in the test suite. An error is an 
unexpected error such as a Nul 1 Poi nterException or ArraylndexOutOfBoundsException. 

The testing of TwentyOnePi ckup was a particularly simple test suite. It required no setup and did not deal 
with objects, just simple stati c method calls. A slightly more complex example is the following which is the 
beginning of a test suite for the PredatorPrey program from Section 7.7, An Example: Predator-Prey Simula¬ 
tion , on page 207. 

iimport junit. framework.TestCase; 

public class TestPredatorPrey extends TestCase { 

. private World world; 

protected void setUpQ { 
world = new World(10); 

// a fox with no rabbits around 
world.cells[3][S] = new Fox(3,3,l); 

// a fox with rabbits nearby 

world.cel 1s[5][5] = new Fox(5,5,l); 

// rabbit that should get eaten by the fox 
world.cel 1s[5][6] = new Rabbit(5,6,1); 

// a rabbit and grass near the rabbit at 5,6 
world.cells[6][7] = new Rabbit(6,7,2); 
world.cells[5] [7] = new Grass(5,7); 
world.cells[6][6] = new Grass(6,6); 

} 

protected void tearDownQ { 

// let the World object get garbage collected 
world = nul1; 

} 

public void testFoxStarvesQ { 

assertEquals(". ", world.cells[3] [3] .next(world) .toStringO) ; 

} 
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public void testFoxLives() { 

assertEqualsC'Fox age 2", world.cells[5][5].next(world).toString()); 

} 

public void testRabbitDiesO { 

assertEquals( M .", world.cel 1 s[5] [6] .next(world).toString()); 

} 

public void testNeighborCounts() { 

// 5,6 is a rabbit with some neigbhors 
world. cel 1s[5][6] .computeNeighbors(worl d); 
assert Equal s(l, Rabbi t. nei ghborCount. getQ) ; 
assertEquals(l,Fox.neighborCount.get()); 
assertEquals(2,Crass.neighborCount.get ()); 
assertEquals (4, Empty.neighborCount.get()); 

} 

} 




Dissection of TestPredatorPrey Program 


• import junit.framework.TestCase; 

public class TestPredatorPrey extends TestCase { 

As with our previous example, we collect the tests into a class that extends junit. frame¬ 
work .TestCase. 

• private World world; 
protected void setUpQ { 

world = new World(10); 

// a fox with no rabbits around 
world.cells[3][3] = new Fox(3,3,l); 

// a fox with rabbits nearby 
world.cells[5][5] = new Fox(5,5,l); 

// rabbit that should get eaten by the fox 
world.cells[5][6] = new Rabbit(5,6,l); 

// a rabbit and grass near the rabbit at 5,6 
world. cel Is[6][7] = new Rabbit(6,7,2); 
world.cells[5][7] = new Grass(5,7); 
world.cells[6][6] - new Grass(6,6); 

} 

The method setup() will be called by the test runner before each test is run. It is used to create any 
objects or perform other initialization that will be needed by the test cases in this class. For our test we 
create a Worl d object and place some specific simulated living things into the world. This test is by no 
means complete but is the start of a complete test. In the test methods that follow we will test some fea¬ 
tures of the Fox class, the Rabbi t class, and the computeNei ghbors () method from the class Li vi ng. 

• protected void tearDownQ { 

// let’s the World object get garbage collected 
world = nul1; 

} 

Complimentary to setUpQ, the method tearDownQ will be called by the test runner after each test is 
run. Tills is important if this TestCase class is part of a larger test suite and we want to make sure we 
don’t keep the test objects around any longer than needed. By setting world to null we have removed 
the last reference to the Worl d object and all of the objects it refers to. 
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# public void testFoxStarvesO { 

assertEquals( M .", world.cel 1s[3][3].next(world).toString()); 

} 

public void testFoxLives() { 

assertEquals("Fox age 2", world.cells[5] [5] .next(world) .toStringO) ; 

} 

public void testRabbitDiesQ { 

assertEquals(".", world.cel 1s[5][6].next(world).toString()); 

} 

Each of these three test methods checks one of the Intended behaviors of moving to the next generation 
in a simulation. The first tests that a fox with no rabbits nearby will starve and die. The second tests that 
a fox properly ages and survives where there is a rabbit around for it to eat. The third tests that the rab¬ 
bit actually got eaten by the fox. 

• public void testNeighborCounts() { 

// 5,6 is a rabbit with some neigbhors 
world.cells [5][6]. computeNeighbors(world) ; 
assertEquals(1,Rabbit.neighborCount.get()); 
assertEquals(1,Fox.neighborCount.get()); 
assertEquals(2,Grass.neighborCount.get()); 
assertEquals(4,Empty.neighborCount.get()); 

} 

} 


In this final test example we test the computeNei ghbors() method that is inherited from the abstract 
class Li vi ng by the Rabbi t class. Notice how each of the four test methods in the TestCase class make 
use of the setup that was performed by setup (). 



In the previous two examples we have only demonstrated a small subset of the features and capabilities of 
the junit framework. You should consult the documentation for junit if you find that the limited set of 
options we have described are insufficent for your needs. 



1 1.3 ASSERTIONS 


java includes the keyword assert which can be used to insert tests directly into source code. Assertions 
serve two purposes. First, assertions are a form of executable documentation about what is supposed to be 
true about some aspect of a program during execution. It could be an assertion about the expected range of 
input values to a method, an assertion about some intermediate computation, or an assertion about the 
result returned from a method. Second, assertions are a form of testing that can run automatically every' time 
the program is run. 

The assert keyword was added to Java beginning with version 1.4. If you are using a 1.4 Java compiler you 
will need to tell the compiler you are using assert as a keyword by adding the compiler flag -source 1.4 to 
your compile line. This was done to allow for a gradual transition of code that might have been using assert 
as an identifier. For example, to compile My Prog ram. java that uses the assert keyword, with a version 1.4 
Java compiler type: 

javac -source 1.4 MyProgram.java 

If you are using a version 5.0 or later compiler, no special flag is required in order to have the compiler rec¬ 
ognize assert as a keyword. 














































11.3.1 Adding assert statements to your program 343 

11.3.1 ADDING ASSERT STATEMENTS TO YOUR PROGRAM 

Let’s begin by redoing our enhanced Counter class from earlier in this chapter. Earlier we modified Counter 
to throw an exception if the initialization parameter was out of an expected range. Here is that example 
again: 

public class Counter { 

//constructors 
public CounterQ {} 
public Counter(int v) { 
if (v < 0 || v >= 100) 

throw new Exception("Invalid initial value."); 
el se 

value = v; 

} 


} 

We could achieve the essentially the same result using assert as shown here. 

public class Counter { 

//constructors 
public CounterC) {} 
public Counter(int v) { 

assert (v >= 0 && v < 100):"Invalid initial value."; 
value = v; 

} 


w m w 

} 

The use of assert instead of the explicit if-statement has two advantages. First, it explicitly indicates that 
this is an assertion and not part of the “normal” processing of the method. Second, for performance sensitive 
code the execution overhead of the assert is extremely small when assertions are disabled - the default 
behavior. This removes the temptation to strip out the assertions once the code is thought to be finished. 

When the assertion fails the program throws an Asserti onEr ror exception. For example, with the above 
Counter class definition, the statement 

Counter c = new Counter(100); 

will throw an exception generating the following output if not caught. 

Exception in thread "main" java.lang.AssertionError: Invalid initial value, 
at Counter.<ini txCounter. java: 5> 
at ... 

There are two forms of the assert statement: 

assert booleanExpression ; 

assert booleanExpression: expression, 

The first form throws an Asserti on Error exception if the booleanExpression is false. The second form is 
the same with the addition that expression will be part of the exception message as seen in the previous 
example with Counter. 
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11.3.2 ENABLING AND DISABLING ASSERTIONS 

By default, assertions are disabled when your program runs. To enable assertions you pass the flag -ea to 
the Java virtual machine. For example: 

java -ea MyProgram 

will enable all assertions except those in the standard Java classes. 

You can also selectively enable or disable assertions in a specific class ( -ea: cl assName ) or package ( - 
ea: packageName. . . ). The flag -da is used to disable assertions. You can combine uses of -ea and -da to 
enable just the assertions you wish. The flags are processed in order. For example, the following command 
will enable all assertions in the package somePackage except for the class SomeCl ass. 

java -ea:somePackage... -da:somePackage.SomeClass MyProgram 

You can also enable or disable assertions in the standard Java classes using -esa and -dsa which are short 
for -enablesystemassertions and -disablesystemassertions. 


11 3.3 PRECONDITIONS, POSTCONDITIONS, AND INVARIANTS 

Preconditions are conditions, boolean expressions, that must be true at the start of a method or block of 
code in order for the method or block to execute properly. Postconditions are conditions that are expected to 
be true when a method or block of code completes. Users of a method can write their code to rely on the con¬ 
ditions asserted by a postcondition. Likewise, callers of a method are expected to establish the preconditions 
for a method before calling the method. 

An invariant is a condition that should “always be true.” For example an invariant might assert that some 
array will always be less than a specified amount. Java does not directly support asserting such global invari¬ 
ants but the assert statement can be used to check an invariant at specific points in a program. 

As methods become longer and more complicated, the use of preconditions, postconditions, and invariants 
becomes even more important. They are easy to write, add robustness to code, and help other readers of the 
code understand its intent. Assertions also help guarantee that defects do not go undetected appearing only 
as undetected incorrect output. Moreover, assertions help you think about correctness. This discipline is ben¬ 
eficial in and of itself. The placement of assertions isn’t restricted to the beginning and ending statements of 
a method, but such placement is natural. The use of assertions is considered to be good programming style. 



1.4 DEBUGGING 


Progr ammin g errors can be rough]y divided into two groups: compile time errors and runtime errors. Com¬ 
pile time errors are also referred to as syntax errors and runtime errors are logical or semantic errors. A key 
difference between syntactic and semantic errors is that you know when all of the syntax errors have been 
eliminated, assuming a correct compiler. Unfortunately, in general you can never be sure that you have elim¬ 
inated all of the semantic errors from a program. 

Syntax errors are much easier to locate and generally easier to correct than runtime errors. The compiler usu¬ 
ally directs you to the line in your program where the error occurs. Occasionally the error is actually on some 
other line but the other line is either nearby or logically related to the line indicated. For example, forgetting 
a semicolon will result in an error message pointing at the line after the line with the missing semicolon. 
Another example is if you forget to add the keyword static to a static method. There error message will point 
at the line where you attempt to call the static method when in fact the error is in the method declaration. 

There are two steps to removing a semantic error. First you need to cause the program to exhibit some unex¬ 
pected behavior. Then you need to determine the cause of the unexpected behavior. This later activity is 
called debugging. Runtime program errors are called bugs because early computers were built using mechan- 
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ical switches called relays, instead of transistors. As the story goes Grace Hopper was trying to determine 
why a computer was not working correctly and the source of the problem turned out to be a moth caught 
between the contacts of one of the relays, preventing the relay from closing. 

The simplest form of debugging is to examine the source code. Often the nature of the unexpected behavior 
will allow a programmer f amili ar with the code to determine a small subset of the program that is most likely 
responsible for the error. Then with a careful code inspection the defect will come to light. 

When simple code examination is insufficient it may be necessary to gather additional information about the 
state of the program at the time the erroneous behavior occurred. A very simple way to do this is insert print 
statements into the program that print out various program variables and indicate what steps the program is 
executing. For example, you might want to print a message each time a particular method is called including 
the values of the parameters passed to the method. This technique does not require any special tools or 
knowledge, however, it can be very time consuming if you need to keep changing what you want printed out 
as you pursue the source of the error. 

Debuggers make it possible to easily examine the state of a running program. Using a debugger you can: 

# stop the program each time it reaches a particular source line in the program or enters a partic¬ 
ular method, 

U examine or modify the value of local variables, parameters, and fields of objects, 

# stop the program when a particular local variable or field is accessed or modified, 

# execute one statement at a time, stopping after each statement to allow for examination of vari¬ 
ables, 

# and much more. 

The standard Java Software Development Kit includes a co mm and line debugger, jdb. Most Integrated Devel¬ 
opment Enviroments (IDEs) also include a graphical debugger which is generally easier to use than jdb. 


1.4.1 JDB 

The standard Java debugging,tool, jdb, provides basic debugger functionality with a command line interface. 
The simplest way to use the debugger is to simply substitute jdb for java when running a program. For exam¬ 
ple, to debug Si mpl ePai ntMenu from Section 9.6, Adding Menus to a GUI, on page 275 type the following at 
your OS command line: 

jdb SimplePaintMenu 

The first thing you will probably want to do is tell the debugger to stop the program when it reaches a partic- 
ular point of interest. Such a stopping point is called a breakpoint. Once you have set one or more break¬ 
points you start the program running. When one of the breakpoints is reached, the debugger will halt the 
program with an appropriate message. At that point you can examine program variables or continue execu¬ 
tion until another breakpoint is reached. Before running jdb on Si mpl ePai ntMenu below, we intentionally 
inserted a mistake into the program. We changed the label for the small pen menu to be “small” instead of 
“Small”. 
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Dissection of a debugging session for SimplePaintMenu 



os~prompt> jdb SimplePaintMenu 


Initializing jdb 
> 


The debugging session begins by starting the debugger with the main class as a paremeter. If the pro¬ 
gram being debugged accepted co mm and line parameters they could also be included. We just substitute 
j bd for java. The greater than symbol > is the prompt from jdb that it is ready for the next command. 
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> stop in PaintListenerS.setPenSize 

Deferring breakpoint Paintlistener3.setPenSize. 

It will be set after the class is loaded. 


The first command we give is to set a breakpoint in the method setPenSi ze() of the Pai ntLi stener3 
class. Because the Java virtual machine has not yet loaded the class it can’t actually set the breakpoint 
but it is telling us that it understood the co mm and and will set the breakpoint when the code for 
PaintListener3 is actually brought into the computer’s memory. 

# > run 

run SimplePaintMenu 

Set uncaught java.lang.Throwable 

Set deferred uncaught java.lang.Throwable 

> 

VM Started: Set deferred breakpoint PaintListener3.setPenSize 

To start the progr ammin g running we issue the command run. The debugger echos the co mm and it is 
running, which would include any command line parameters if we had provided any at startup. It then 
prints information showing that the debugger will automatically halt the program if an uncaught excep¬ 
tion is thrown by the program. Then we see the > prompt which means we could type another co mm and, 
but the debugger then immediately continues because the class PainterListener3 has been loaded 
into memory and it notifies us that the breakpoint has been successfully set. The validity of a deferred 
breakpoint is not checked until the class is loaded. If we had misspelled the name of the method here is 
where the mistake would be caught with an appropriate message being printed. In addition, if there was 
a mistake in a deferred breakpoint, the program will be stopped at the point that the error was noticed 
so you will have a chance to correct it. 

Breakpoint hit: "thread=AWT-EventQueue-0 M , 

PaintListener3.setPenSize(), line=12 bci=0 
12 if (size.equals( n small n )) { 

AWT-EventQueue-0[l] 


M 


This next few lines of output occur only after we switch to the running application and use the menus to 
try and change the pen size. This action causes the program to reach the breakpoint we set and the pro¬ 
gram execution is halted. The earlier > prompt has now changed to AWT- Even tQueue-0 [1] . This new 
prompt tells us that it was the AWT-EventQueue0 thread that actually hit the breakpoint (see Section 8.2 
Listening to events). The [ 1] tells us that we are currently set to exa mi ne the variables for the method 
activation that is at the top of the execution stack. It is possible to examine variables for other methods 
that have not yet completed using the up and down commands to jdb. 



AWT-EventQueue-0[l] list 

8 // specify one of three pen sizes, 

9 // Small, Medium or Large 

10 // radius and diameter are inherited 

11 public void setPenSize(String size) { 

12 => if (size.equals("Small")) { 

13 radius = 0; 

14 diameter = 1; 

15 } 

16 else if (size.equalsC’Medium")) { 

17 radius = 3; 


Here we used the list command to list a few lines of code around the point where execution was halted. 
We see that the actual line at where execution was halted is indicated by ->, Also the line numbers are 
printed. We can use these line numbers in setting additional breakpoints with the command “stop at 
ClassName: lineNumbeP '. At this point we can also list other parts of the current class with the com¬ 
mand “list UneNu mbef\ 
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% AWT-EventQueue-0[l] locals 
Method arguments: 
size = "small" 

Local variables: 


Next we examine the values of the local variables, which include any parameters passed to the method. 

# AWT-EventQueue-0[l] next 
> 

Step completed: "thread=AWT-EventQueue~0", 

PaintListener3.setPenSize(), line^!6 bci=22 
16 else if (size.equals("Medium")) { 

The command next continues execution until the next source line in the current method is reached. In 
this case we see that conditional for the if statement must have evaluated to false and we are now ready 
to test the conditional for the else-if that follows it. If we had not already noticed it, this unexpected 
behavior should cause us to carefully ex amin e the conditional expression and see that we have been 
passed “smal 11 but are expecting "Smal 1 

AWT-EventQueue-0[l] cont 

> watch PaintListener3. radius 

Set watch modification of PaintListener3.radius 

> 

Breakpoint hit: "thread=AWT-EventQueue-0", PaintListener3.setPenSize(), line=12 
bci=0 

12 if (size.equalsC'small")) { 


At this point we have found our bug and could terminate the session. However, we will continue and 


demonstrate two more co mm ands. Here we have used cont which is the continue command. It resumes 
the execution from the place where it last stopped resulting in the original > prompt being printed. We 
then tell the debugger to stop if the program attempts to modify the field radi us in the class 
Pai ntLi stener3. We get another > prompt and then no further output is generated until we switch to 
the application and again try to change the pen size. Notice that the breakpoint remains active until we 


remove it, which we can do with the command “cl ear Pai ntLi stener3. setPenSi ze”. 


AWT-EventQueue-0[l] cont 
> 

Field (PaintListener2.radius) is 3, will be 6: 

"thread==AWT~EventQueue-0", PaintListener3.setPenSize(), line-21 bci=61 
21 radius = 6; 


We immediately continue from the breakpoint at the start of setPenSi ze() and then execution halts at 
line 21 just before radi us is changed from 3 to 6. 

H AWT-EventQueue-0 [1] dump this 
this = { 

PaintListener2.radius: 3 
PaintListener2.diameter: 6 

} 

In addition to examing all locals with the command 1 ocal, we can dump the contents of an object with 
dump. In this example we are dumping the contents of the object that is pointed to by the current value 
of the special keyword thi s, which is the Pai ntLi stener3 object that is being manipulated. 

• AWT-EventQueue-0[l] quit 



At this point we end the current debugging session. 
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11.4.2 USING JDB ON PROGRAMS THAT READ FROM SYSTEM.IN 

The program jdb reads its commands from the standard input stream, System. i n. Consequently if you try 
and use jdb, by typing “ jdb MyProgram”, to debug a program that also reads input from System. i n, there is 
no way for you to send input to your program because all of your typing is caught by jdb. Fortunately there is 
another way to use jdb to debug your program. 

You can attach jdb to a program that has already been started, provided the program was started with some 
additional parameters to the java virtual machine telling it that it is ok for a debugger to attach to the pro¬ 
gram. This can be done in several ways, we will show you just one way. 

In the following example we run the debugger onTwentyOnePickup from Section 4.9, Problem Solving: A 
Computer Game , on page 97 that has been modified to contain an error for illustrative purposes. 


os-prompt>java -agentlib:jdwp=transport=dt_shmem, server=y, address=someString 
TwentyOnePickup 

Listening for transport dt__shmem at address: someString 


The java command should be all on one line, although it appears to break across two lines in the example 
above. The parameters given above will result in the program being suspended once the Java virtual machine 
has been started. Consequently there will be no output from the program yet. 

In another console window we need to start up the debugger and attach it to this program. We show how to 
do this in the following example. 


os-prompt>jdb -attach someString 
Set uncaught java.lang.Throwable 
Set deferred uncaught java.lang.Throwable 
Initializing jdb ... 

> 

VM Started: No frames on the current call stack 
main[l] 


At this point we are connected and can begin issuing debugger commands. 




Dissection of a debugging session for TwerttyOnePickup 


% os~prompt> jdb -attach someString 

Set uncaught java.lang.Throwable 

Set deferred uncaught java.lang.Throwable 

Imtializing jdb ... 

VM Started: No frames on the current call stack 

mai n [1] stop in TwentyOnePickup.playerMove 
Deferring breakpoint TwentyOnePickup.playerMove. 

It will be set after the class is loaded. 

The first thing we do is set a breakpoint in the method pi aye rMove (). 
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main[l] step 

> Set deferred breakpoint TwentyOnePickup.playerMove 

Step completed: "thread=main”, TwentyOnePickup.mainC), line=15 bci=0 
15 printlnstructionsO; 

main[l] list 

11 * stones in the pile to start with. 

12 * The last one to remove a stone wins. 

IB V 

14 public static void main(String[] args) { 

15 => printlnstructionsO; 

16 // create the initial pile with 21 stones 

17 int numberOfStones = 21; 

18 // keep track of who moved last 

19 boolean piayerMovedLast = false; 

20 while (numberOfStones > 0) { 


To show that the program has not yet done anything, we issue a step and then a 1 i st co mm and and see 
that it is now ready to execute the first line of mai n (). We also get a message that the deferred break¬ 
point has now been set because the class was loaded into the computer’s memory. 

main[l] cont 
> 

Breakpoint hit: "thread=main", TwentyOnePickup.playerMoveQ, line^56 bci=0 
56 int move = getUserMove(numberOfStones); 

main[l] list 

52 * The number of stones remaining after the 

53 * user's move. 

54 */ 

55 static int playerMove(int numberOfStones) { 

56 => int move = getUserMove(numberOfStones); 

57 

58 numberOfStones = numberOfStones - move; 

59 System.out.println("There are "+numberOfStones 

60 + " stones remaining."); 

61 return numberOfStones; 

We continue executing the program and it hits the breakpoint in pi ayerMove(). 

• main[l] step 
> 

Step completed: "thread=main”, TwentyOnePickup.getUserMoveO> line=96 bci=0 
96 System. out. println("Your move - how many stones" 

Here we illustrate the difference between the co mm ands step and next. The command next would have 
continued execution until it reached the next statement in the current method (line 98). The command 
step executes just one source line, which in this case takes us into the method getUserMoveO. 

• mainfl] where 

[1] TwentyOnePickup.getUserMove (TwentyOnePickup.java:96) 

[2] TwentyOnePickup.playerMove (TwentyOnePickup.java:56) 

[3] TwentyOnePickup.main (TwentyOnePickup.java:21) 

The where command is very useful. It shows us all of the method invocations that are on the current call 
stack. Here we see that main-0 at line 21 called playerMoveQ, which in turn called getUserMoveO 
from line 56, which is currently stopped at line 96. 
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• main[l] next 

> 

Step completed: "thread=main", TwentyOnePickup.getUserMoveC), line=98 bci=8 
98 int move = input.nextlntO ; 

main[l] next 

> 


After issuing two more next commands we get the debugger prompt > which tells us the program is run¬ 
ning. At this point we need to switch over to the other co mm and window where we started the program 
and enter some value. For testing purposes we will enter 4 as the number of stones we want to remove. 


Step completed: ”thread=main”, 

TwentyOnePickup.getUserMoveC), line=100 bci=15 
100 while (move > numberOfStones && move < 1 && 

main[l] locals 
Method arguments: 
numberOfStones = 21 
Local variables: 
move - 4 


Once we have entered input for the program (in the other window), the breakpoint is reached. We imme¬ 
diately ask to examine all local variables. We see that indeed a 4 was read in as the user input. 

• main[l] next 
> 

Step completed: n thread=main", 

TwentyOnePickup.getUserMoveC), line=101 bci=79 
101 move > 3) { 

main[l] next 
> 

Step completed: "thread=main", 

TwentyOnePickup.getUserMoveC), line=113 bci=94 

113 return move; 

Issuing two more next commands we see that the loop body was never entered. If we didn’t already real¬ 
ize it, at this point this should allow us to notice that we have an error in the conditional for the loop. We 
have used and operators where we needed or operators. 

# main[l] quit 



We have found the bug so we terminate the debugging session. 
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11.43 OTHER JDB COMMANDS 


The previous examples have illustrated only a small subset of the available jdb commands. For a complete 
list of the jdb commands and a brief description use the jdb command help. Here we describe a few more of 
the commands that are most likely to be of use and repeat for reference those commands we did use in our 
examples. 

• cl ear cl ass name, met hod name - remove a breakpoint 



cont - continue exeucting from a breakpoint 

eval expression - evaluate an expression and print the value (as of jdk5.0 this still only works for 
simple variables not arbitrary 7 expressions) 

list- list source lines around where program execution halted 

list n- list lines around source line number n 

1 ocal s - print the value of all local variables and method parameters 

next - execute up to the next line in the current method 

% pri nt expression - same as eval 

quit- exit the debugger 

run - begin program execution 

# step - execute one line of code 

• stop at classname : n - set a breakpoint at a line number 

® stop i n classname . methodname - set a breakpoint in at the start of a method 

up/down - move up or down the call stack allowing for examination of locals in other active 
methods on the stack 

watch classname . variable - stop program execution just before the program writes to a field 



1 1.4,4 A DEBUGGER WITH A GUi 


Most programmers today have access to an Integrated Development Environment (IDE) that includes a graph¬ 
ical interface to a debugger. The standard debugger jdb has the advantage that it is available on any platform 
on which Java rims. The disadvantage is that the command hne interface is not as easy to use as a well 
designed GUI. 


To give you a sense of what a GUI debugger looks like, here is a screen shot of the Eclipse IDE (http:// 
www.eclipse.org) while debugging the TwentyOnePi ckup program. In this shot we can see that there is a 
breakpoint set on the first line of getUserMove () as shown by the symbol in the margin to the left of the line 
of code displayed in the center pane and that execution has stopped on the while statement, indicated by the 
arrow hi ghligh ting of the line. We can also see the variables listed in the upper right pane and the call stack 
in the upper left pane. Also, the console window is at the bottom showing the program output and our input 
value of 4. 


All of this information is available using jdb but with a GUI it can all be visible at once without having to 
issue separate commands for each piece. To set or remove a breakpoint you simply chck in the margin to the 
left of the line where you want to set or remove the breakpoint. The local varibles are displayed automati¬ 
cally. Continuing or single stepping the execution is performed by chcking on the approriate command sym¬ 
bol in the debug window. 
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Summary 


• An exception Is generally used to describe something unexpected that happens in a program, such as an 
array index out of bounds error or some problem with reading from a file. 

• A t ry block can be used to catch or “handle” an exception. If an exception of the specified type is thrown 
during execution of the try block, control is transferred immediately to the catch block. 

• Some exceptions, such as IndexOutOf BoundsExcepti on, are generated automatically by the Java virtual 
machine. Exceptions can also be generated exphcitly by a program, which is called throwing an excep¬ 
tion. A throw statement is used to throw an exception. 

• Programs can throw an instance of a predefined exception type or you can create your own exception 
types by subclassing one of the existing exception classes, 

• All exceptions are derived from the class java.1ang. Throwable. Those exceptions that are also derived 
from java. 1 ang. Runti meException or java, lang . Error don’t need to be declared with a throws 
clause at the beginning of a method. These are unchecked exceptions. New exception classes that are a 
subclass of java. 1 ang . Exception but not a subclass of java. 1 ang . Runti meExcepti on must be 
declared with a throws clause. In general, user-defined exceptions shouldn’t be derived from Runtime- 
Exception or Error. Doing so defeats some of the type-checking safeguards that can help detect errors 
at compile time. 


• They are many approaches to testing software: unit testing, integration testing, functional testing, black¬ 
box testing, and regression testing are some of them. 

• The widely used open source project junit, provides a framework for building and r unning tests. Such a 
framework makes it easy to organize and run a set of tests. 

• Assertions are a form of testing built directly into a program. Java provides support for assertions with 
the keyword assert. 

• The simplest and most common use of assertions is as preconditions and postconditions on methods. 

• The standard Java development kit includes a debugger that can be used to view the internal state of a 
program as it executes. 



Review Questions 


1. True or false? Exceptions happen only when a run-time error is discovered. 

2. What types of exceptions don’t have to be declared with a throws clause at the beginning of a method 
definition? What are such exceptions called? 

3. If an exception isn’t handled by a method, what happens to it? 

4. Give an example of a standard Java exception that must be declared with a throws clause and one that 
doesn’t have to be declared with a throws clause. 

5. What happens if you use an array index that is out of range? 

6. True or false? Every user-defined exception is a checked exception. 
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7. What is wrong with the following code fragment? 
try { 

m m m 

} 

catch (Exception e) { 

m m m 

} 

catch (IndexOutOfBoundsException e) { 

■ ■ K 

} 

8. What is printed by the following program? 

class ExceptionReview { 

public static void main(String[] args) { 
int x; 
try { 

x = foo(10); 

} 

catch (MyException e) { 

System.out.println("Caught an exception: + e); 

x = 99 ; 

} 

System.out.println(x); 

} 

static int foo(int x) { 

System.out.pri ntl n("foo started with " + x); 
int temp = bar(x); 

System.out.pri ntln("foo returning " + temp); 
return temp; 

} 

static int bar(int y) { 

System.out.println("bar started with + y); 
if (y > 0) 

throw new MyException("just a test"); 

System.out.printlnC'when is this executed?"); 
return y; 

} 

} 

class MyException extends RuntimeException { 
public MyException(String message) { 
super(message); 

} 

} 

9. What happens if you divide by zero? Be sure to test it. 

10. Is a fi nal 1 y clause executed if no exception is thrown Inside its try block? 
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Exercises 


1. Write a robust method for reading in integers. If the user fails to type in a valid integer, print a message, 
skip over the offending line of input, and try again. To skip over the rest of a line of input you can use 
next Li ne() from Scanner, which reads everything up to and including the next newline character. 

2. Redo Exercise 1 to fail if the user types in an integer outside the range 0 to 100 inclusive. This technique 
is important in data entry programs where valid data is known to be in a given range. 

3. Redo Exercise 1 to include user confirmation of the entered value. 

4. If you attempt to open a file for reading using 
new Fi 1 eReader (filename) 

and the file doesn’t exist, a java. io. Fi leNot Found Except ion will be thrown. Use a try block to create 
a robust program to read a file and echo its contents to the screen. The program should prompt for the 
name of the file. If the file can’t be opened, the program should print a suitable message and ask for a 
new file name to be entered. 

5. Use a try block in the method computeNei ghborsQ in class Li vi ng for the Predator-Prey simulation in 
Section 7.7, An Example: Predator-Prey Simulation , on page 207. Using try-catch, you can lift the 
restriction that computeNei ghborsQ is never called with a border cell. If an attempt is made to go 
beyond the array bounds, the exception should be caught and treated as an empty cell. Modify Li vi ng 
and PredatorPrey to allow updates of the border cells. 

6. Using a DataOutputStream, create a program that writes some random numbers to a file. Have the user 
specify on the command line the number of random values to write. Using a DatalnputStream, create 
another program to read in those random values. The program that reads the random numbers shouldn’t 
be told how many numbers are in the file. Instead the end-of-file should be detected by using a try block 
to contain the read statement. Print the distribution of random values using 10 intervals. 

7. Write a program to print out the real roots of the quadratic expression ax 2 + bx+ c. Recall that, for there 
to be two real roots, the discriminant b 2 - 4 ac must be greater than 0. If this condition fails, use an 
exception to generate a message that the quadratic expression doesn’t have two real roots. Compare this 
methodology to one that avoids throwing an exception when handling this case. 

8. Write a factorial method that throws an exception if the integer n would lead int factorial (i nt n) to 
compute an incorrect value because of integer overflow. Recall that i nt values go only to approximately 
2 billion. Test the method by printing a table of values for n! until this exception occurs. 

9. Repeat the previous exercise for long factorial (long n). 

10. The method Math. sqrt () when given a negative argument returns Doubl e. NaN (not a number). Write 
and test your own version mySqrt () that throws an exception when given a negative number. 
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Dynamic data structures can expand and contract during computation, for example, as in a list of things to 
do, from which you can add or delete items. Computers are frequently used to store and manipulate lists of 
data, which can be represented many ways in a computer. In Section 5.13, The container ArrayListo, on page 
150, we showed how to use a standard Java class that is an implementation of a dynamic data structure. In 
this chapter we show how to implement a 




is to be manipulated. Will items be added 
at the top of the list, at the bottom, or somewhere in the middle? Will the items in the list be in some partic¬ 
ular order, such as alphabetical? Which will be more common: searching for an item in the list or inserting a 
new item in the hst? Many more such questions have to be considered in deciding how to implement a list. 
For the most part these are questions for an advanced text on data structures. 



difference between arrays and the hst implementations that we describe in this chapter is that the capacity 
of an array can’t change. If you need to change the size of a hst implemented as an array, you have to create a 
new array, larger or smaller, and then copy the items from the old array to the new, resized array. 

The hst data structures we describe in this chapter are called dynamic data structures because they can be 

is that at least part of the data 



structure will be implemented by a class that contains, as a member, a reference variable of the same type as 
the class itself. For this reason, these data structures are frequently called self-referential , or recursive , data 


structures. 



The simplest type of self-referential hst structure is a sequence of elements. Each element contains some 
data and a reference, often called a pointer , to the next element in the hst. We can use this approach in Java, 
as shown in the following example, allowing us to create an arbitrarily long hst of integer values. 


//IntListElement.java 
class IntListElement 
IntListElement(i nt 
IntListElement next 


- a self-referential 

{ 

value) { data = value 
; //self-referential 


class 
; } 


int data; 


} 
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The declaration oflntListElement has two fields. The field data stores the data member for this element. 
The reference variable next is called a link. Each element is linked to a succeeding element by way of the 
member next. For convenience, we also include a constructor that fills in the data field. A list implemented 
with this structure can be conveniendy displayed pictorially with links shown as arrows. In the following fig¬ 
ure the field data contains the value 2. The field next is pointing to some other, unspecified element. 



If there is no succeeding element because we are at the end of the list, the field next contains the special 
value null. We can create two elements with 

IntListElement first = new IntListElement(l); 

IntListElement second = new IntListElement(2); 

The next field defaults to nul 1. Pictorially, the result of this code is 


first-► 

null 

j 

null 


r i 

f 

[ 2 


second 


To make these two elements into a list, with f i rst as the first element in the list, we link them, 
first.next = second; 

The diagram now looks like this. 


first-► 


i ^ 

null 


1 1 


2 


second 


The links allow us to retrieve data from successive elements, beginning with the first element. Thus 
fi rst.next.data 
has the value 2. 


Common Programming Error 


A common mistake is to attempt to access a field or method for an object with a reference value that is 
null. Doing so generates aNullPointerException. For example, given the short list that we just cre¬ 
ated, attemp tin g to reference fi rst. next. next. data would generate a Null Poi nter Except ion. The 
expression first.next.next refers to the reference value stored in the field next of the second ele¬ 
ment in the list. This field is null, so fi rst. next. next .data is asking for the field data of the null 
value. 


In some cases letting the program abort with the exception is acceptable. In other cases using the mech¬ 
anism for handling exceptions may be appropriate—to catch the exception and take some corrective 
action. Yet another approach is to test for a null reference before accessing any fields. Better still is to 
design the program so that such null references can never occur. 
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12.2 A LINKED LIST IMPLEMENTATION OF A STACK 


We’ve already discussed arrays, winch are a type of container. That is, an array contains a sequence of values 
of the same type. Another common container used In computers is a stack. A stack , like an array, stores a 
sequence of similar objects. The difference between stacks and arrays lies In how you put values in the con¬ 
tainer. In an array, you create the container with a fixed size and then store and retrieve values at any index 
in the array. In contrast, a stack is like a stack of plates. You can add a plate to the top of the stack, you can 
look at the plate on the top of the stack, and you can remove a plate from the top of the stack. You can’t look 
at, add, or remove plates from the middle. 

A stack class for storing integers should have the following methods. 

class IntStack { 
int top() { ... }; 
void push(int value) { ... }; 
int pop() { ... } 
boolean empty() { ... } 

} 

The method topO returns the value of the integer on the top of the stack without changing the stack’s con¬ 
tents. If the stack is empty, it returns a 0. The method push() pushes an integer value onto the top of the 
stack, increasing the number of integers contained in the stack. The method pop() returns the same t hing as 
top(), but it also removes the top value from the stack, reducing the number of integers contained in the 
stack by 1. If the stack is empty, pop() returns 0 and the stack is unchanged. The method emptyO returns 
true if the stack is empty and fal se otherwise. The following figure shows the integers 1, 2, and 3 being 
pushed onto a stack and then popped back off. 
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There are many ways to implement the operations of the class IntStack. An important aspect of Java (and 
other object-oriented languages) is the language syntax that allows you to hide and change the implementa¬ 
tion without affecting other parts of a program that use the class. Here we implement the class IntStack, 
using the class IntLi stEl ement introduced at the be ginnin g of the chapter. 

//IntStack.java - a stack implemented with a list 
class IntStack { 

int top() { 

if (top != null) 
return top.data; 
else 

return 0; 

} 

int popQ { 

int result - top();; 
if (top != null) 
top = top.next; 
return result; 

} 
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void push(int value) { 
if (top == null) { 

top = new IntListElement(value); 

} 

else { 

IntListElement temp = new IntListElement(value); 
temp.next = top; 
top = temp; 

} 

} 

boolean emptyO { return top ===== null; } 
private IntListElement top = null; 




Dissection of the Class IntStack 

• int top() { 

if (top ! = null) 
return top.data; 
else 

return 0; 

} 

The private instance variable top is a reference to the IntLi stEl ement at the top of the stack. If the 
stack is empty, top equals null and the result of top () is 0. Otherwise, the result of top() is the data 
field for the element referred to by top. Note again that Java allows a variable and a method to have the 
same name. 

* int pop() { 

int result = top(); 
if (top != null) 
top = top.next; 
return result; 

} 

We reuse the method top() to find the value that should be returned from pop(). By reusing our code in 
this way, we reduce the chances of making a mistake. If the stack isn’t already empty, we move top to 
point to the next element in the list, thus removing what was the top element from the stack. We need to 
save the result before moving top; otherwise, we wouldn’t be able to find the value to return. 

void push(int value) { 
if (top -= null) { 

top = new IntListElement(value); 

} 

else { 

IntListElement temp = new IntListElement(value); 
temp.next - top; 
top = temp; 

} 

} 

We must check for the special case of pushing onto an empty list, in which case we simply set top to be 
a new element. If the stack isn’t empty, we create a new element, set its link to point to the current top of 
the stack, and then move top to point to the new element. In both cases, we then store the new val ue in 
the data field of the new top element. The next figure shows the sequence of inserting an element into a 
nonempty stack. Here, 1 and 2 were previously pushed onto the stack, and we are now executing 

push(3). 
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% boolean emptyO { return top -- null ; } 
private IntListElement top = null; 

The method empty () is straightforward, returning true if the stack is empty. The only instance variable 
is the pointer to the top element. Note the absence of any specification of how large the stack will be. 




123 A SINGLY LINKED LIST 


A stack is a specialized hst because it permits insertion and removal of elements from only one end of the 
hst, the top. In this section we consider a more general hst class that implements a singly linked hst. This 
class allows for insertion, removal, and examination of elements at any point in the hst. We could just use the 
class IntListEI ement in each program that uses lists. Doing so, however, would require us to recode repeat¬ 
edly the error prone operations of connecting and disconnecting links. Instead, we create a class that does all 
of the work for us. 

With a stack, we always know where an insertion or removal is going to take place, namely, at the top. With a 
general linked hst, we need some way to specify where the insertion or removal should be performed. We 
specify the location by having a variable called cu r rent that refers to an arbitrary element in the hst. We can 
then move current from one element to the next. Here is a specification of our class, without any method 
bodies. 

class IntList { 

void insert(int value) 

/* Insert after the element referred to by current and move current 

* to the new element. If current doesn’t refer to any element, 

* then insert at the head and move current to the new element. 

V 

int next() 

/* Advance current to the next element and return that element. 

* If there is no next element or the list is empty, throw an exception. 

* If current doesn’t refer to any element on entry to this method, 

* then the first element in the list is returned and current is set 

* to the first element. 

*/ 
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int currentO 

/* Return the current element. If the list is empty or there is no 

* current element, throw an exception. 

* Initially current doesn't refer to any element. 

V 

void removeQ 

/* Remove the current element advancing current to the next element. 

* If there is no next element, which happens when removing the last 

* element, set current to not refer to any element. 

* This is equivalent to moveToHeadO . 

* If current doesn't refer to any element on entry, removeQ does nothing. 

* / 

void moveToHeadO 

/* Set current to not refer to any element, which is interpreted to mean 

* before the first element. 

* A subsequent call to nextQ will return the first element. 


boolean hasNextO 

/* Returns true if current isn’t the last element in the list. 

* This is intended to be used in conjunction with next() to loop through 

* a list, examining each element. 

* Note that this isn’t telling us if the list is empty, but rather whether 

* a subsequent call to next() will succeed without causing an exception. 

V 


Before looking at an implementation of this class, let’s look at some code involving the use of the class. 


//IntListTest.java 
class IntListTest { 

public static void main(String[] args) { 

IntList list = new IntListO; 

// insert the integers 1 through 10 in the list 
for (int i=l; i<=10; i++) 

1ist.insert(i); 

// print the list 
1 i st .moveToHeadO ; 
whi 1 e Clist.hasNextO) 

System.out. pri ntln(li st .nextQ) ; 


} 


} 


// try an insertion and a deletion 
list.moveToHead Q; 


list. nextQ ; 
list. nextQ ; 

1ist.insert(25) 
list. nextQ ; 
list. removeQ ; 


// current is 1 
// current is 2 
// insert 25 between 
// current is 3 
// remove 3 


positions 2 and 3 


// print the list again 
list.moveToHeadO ; 
whi 1 e (list.hasNextO) 

System, out. pri ntl n(l i st. nextQ) ; 


This program prints 1 through 10 and then prints 1 through 10 with 3 replaced by 25. We use next Q both to 
retrieve a particular element and to advance current. If we aren’t concerned about the current element, we 
can simply ignore the value returned by nextQ. Note that the IntLi stTest program doesn’t refer to 
IntLi stEle me nt. Thus the code is independent of how IntList is implemented. It could be implemented 
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with an array (see Exercise 8 on page 385), with a list built of IntLi stEl ements, as we do shortly, or with 
some other class. 

Owing to the length of IntLi st, we present only the dissection, without first presenting the complete class. 




Dissection of the Class IntLi st 

• class IntList { 

private IntListElement head, current, previous; 

There are three instance variables. The variable head always refers to the first element in the list or is 
nul 1 if the list is empty. The variable current can refer to any element in the list. If current is nul 1, it 
is assumed to be pointing before the first element. In this way, i nsert () always inserts an element after 
current. The variable previous always points to the element before current. It is needed to simplify 
removal of elements. If current is pointing to the first element, previous will be nul 1. 

• void insert(int value) { 

previous = current; 

if (current != null) { 

IntListElement next = current.next; //step 1 

current.next = new IntListElement(value);//step 2 

current = current.next; //step 3 

current.next = next; //step 4 

} 

else if (head != null) { 

current = new IntListElement(value); 
current.next = head; 
head = current; 

} 

else /* list is empty */ 

head = current = new IntListElement(value); 

} 

Note that inserting in a list is much more complicated than pushing onto a stack. The variable previ ous 
is always set to current because current moves forward to the new element. There are three cases: 
current is pointing to some element in the list, current isn’t pointing to any element but the list isn’t 
empty, and the list is empty 7 . The last case is easy: Point head and current at the new element. The mid¬ 
dle case causes a new element to be inserted before the current first element. The following diagram 
shows an example of the middle case. Part (a) shows the initial list of 10 elements created by the first 
loop in IntLi stTest just after the first 1 i st. moveToHeadQ. Part (b) shows the result of subsequently 
executing listlnsert(99). 
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The remaining case is the general case when an element is inserted after an existing element. The follow¬ 
ing diagram shows the insertion of 25 between 2 and 3, as done with IntLi stTest. The comments // 
step 1 and so on in the code correspond to the s imil ar labels on the arrows in the diagram. 



• int nextC) { 

previous = current; 
if (current — null) 
current = head; 
else 

current = current.next; 
return current.data; 

} 

If currentis null, the “next” element is the first element in the list. If current is null at the return 
statement, a Nul 1 Poi nterException is thrown automatically. Abetter solution is to test for this situa¬ 
tion and throw a NoSuchEl ementExcepti on . (See Exercise 5 on page 427.) 

• int currentQ { 

return current.data; 

} 

This statement simply returns the value of the field data for the element pointed to by current. If cur¬ 
rent is nul 1, thi s statement throws a Null Poi nter Except ion automatically. As with nextO, a better 
solution is to throw a NoSuchEl ement Excepti on. 

• void remove() { 

if (head == null) return; 
if (current ===== null) return; 

if (current ===== head) 

head = current = current.next; 
else 

current = previous.next = current.next; 

} 

There are four cases for removal: The list is empty, no element is selected, the first element is selected, 

and some element other than the first is selected. Only the last two actually remove an element. Remov¬ 

ing the first element is special because we also need to adjust head to point to whatever followed the 
first element. Removing an element other than the first element requires the use of previous to link the 
element prior to the removed el em ent to the element that followed the removed element. 
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void moveToHeadQ { 
previous = current 

} 


null 


boolean hasNextO { 

if (current != null) 
return current.next != 
else 

return head != null; 

} 


null; 


These two short methods complete our implementation of Intli st. There are two cases for hasNext (). 
First, ifcurrentisnull, the next element is the first element if there is one. We therefore test whether 
the list is empty. Second, if current isn’t null, the next element is whatever comes after current. In 
this case we test whether the next field of current isn’t null. 
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12.4 MORE OPERATIONS ON LISTS 




In the previous section, we introduced and described a class IntLi st that supported arbitrary insertion and 
removal but implemented only a minimal set of operations. Many more common operations can be used on 
lists, and implementing them once in our list class allows us to use them in other programs. The following is 
a list of typical operations; for completeness we included those already implemented. 

Linear List Operations 

# Create an empty list. 

Insert after the current position. 

# Insert before the current position. 

# Insert at position n in the list. Zero means insert before the first element. 

# Remove the element at the current position. 

# Find an element in the hst. 

# Append the elements of one hst to the elements of another hst. 

# Count the elements in a hst. 

# Retrieve the current element. 

# Move the current position forward. 

# Move the current position backward. 

# Move to the head of the hst. 

# Move to the end of the hst. 

# Print a hst. 


1 2.4.1 IMPLEMENTING THE METHOD toStringO FOR THE CLASS IntList 

Some list operations are easier to implement than others. A simple but useful operation is printing a hst, 
which we did in our examples. However, by creating a method to print the hst, our progr amming task 
becomes simpler. As discussed in Section 7.2, Overriding Instance Methods, on page 197, the preferred 
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approach for printing objects in Java is to create a method toStri ng(), which returns a Stri ng representa¬ 
tion that can then be printed. Here is a simple implementation of toStri ng (). 

//excerpt from IntList.java 
public String toStringO { 

IntListElement cursor = head; 

StringBuffer result = new StringBufferQ ; 
while (cursor != null) { 

result.append(cursor.data + "\n"); 
cursor = cursor.next; 

} 

//Convert the final StringBuffer to a String using 
//method toStringO from class StringBuffer. 
return result.toString(); 

} 

The class Stri ng is implicitly derived from the class Object, as are all classes except the class Object itself. 
Because the method toStri ng() is defined as a public method in Object, the method, when redefined in 
other classes, must also be public — hence the keyword publ i c in the definition. (See the discussion in Sec¬ 
tion 7.3, The Access Modifiers private and public Revisited , on page 199.) 

Often, a convenient way of working with lists is to write recursive methods. We can easily write a method that 
recursively calls itself to generate a string representation of a hst when given a reference to the first element 
in the hst. 

static String toStringRecursive(IntListElement first) { 
if (fi rst ===== null) 
return " M ; 
el se 

return (first.data + "\n") + toStri ngRecursive(first.next); 

} 

Using this method, toStringO in the class IntLi st can be implemented as 

public String toStringO { 

return toStringRecursive( head ); 

} 

Note that there are no local variables in either of these last two methods. The result is built in the stack of 
method calls. Suppose that the hst contains the elements 10, 20, and 30, in that order. Then a call to 
toStri ng () would result in the following sequence of calls. 

toStri ng() 

toStringRecursive(first.data is 10) 
toStringRecursive(first.data is 20) 
toStringRecursive(first.data is 30) 
return n 30\n" 
return "20\n30\n" 
return ”10\n20\n30\n" 
return "10\n20\n30\n" 

Note how the result is built in reverse order as the method calls return. 


1 2.4,2 DOUBLY LINKED LISTS 

Implementing the “move current position backward” operation would be rather difficult if we used our 
classes IntLi st and IntLi stElement. In order to move backward, we would have to move back to the 
beginning and then move forward again, stopping when current reached what used to be the preceding ele¬ 
ment. To solve this problem, we can create a new hst element class that contains two links—one pointing to 
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the next element and one pointing to the preceding element. Such a list is called a doubly linked list. Here is 
our new list element. 

//IntDListElement - for doubly linked lists 
class IntDListElement { 

IntDListElement(int value) { data = value; } 

IntDListElement next; 

IntDListElement previous; 
int data; 

} 

We can create a list of three elements with the following code. 

IntDListElement first = new IntDListElement(l); 

IntDListElement second = new IntDListElement(2); 

IntDListElement third = new IntDListElement(3); 

first.next = second; 

second.previous = first; 

second.next = third; 

third.previous = second; 

Pictorially, this approach would result in the following structure. 



We leave it for you to do as an exercise to utilize this doubly linked element in a doubly linked list class that 
supports moving both backward and forward through the list. 



1 2*3 A GENtRlL STACK 


The list and stack classes that we implemented in the preceding sections work only with integers. What if we 
wanted to store strings or other objects on a stack? One solution would be to create different classes for each 
type, which is cumbersome and unnecessary. Recall that Java supports polymorphism, which means that we 
can create one class to handle many different types. The changes to our previous classes are minor. Let’s 
start with a generic list element. 

//ListElement.java - a generic list element 
class ListElement { 

ListElement(Object value) { 
data = value; 

} 

ListElement next; 

Object data; 

} 

We replaced i nt with Object. The class Object is a standard Java class, and a reference of type Object can 
refer to any nonprimitive type. In order to store primitive type values in our generic Li stEl ement, we need 
to use the standard Java classes that turn primitive types into reference types (see Section 7.11.2, Automatic 
Boxing of Primitives, on page 220). Recall that there is one such class for each primitive type. For example, the 
class Integer corresponds to the primitive type i nt, and new Integer (3) is a nonprimitive value that cor¬ 
responds to the primitive value 3. To create a Li stEl ement storing the value 3, we can use 


ListElement eleml = new ListElement(new Integer(3)); 
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Similarly, we could create a Li stElement containing the f1 oat value 1.25 with 
ListElement elem2 = new ListElement(new Float(1.25f)); 

Strings don’t require any special handling because they are already reference types. Here is a Li stEl ement 
containing a Stri ng. 

ListElement elem3 = new ListElementC'element 3"); 

To retrieve the data from the elements, the program using the data has to know wliat type of value is really 
there. Provided that we know the true type, we can use a cast to convert from Object back to the true type 
(see Section 7.11, Type conversions and Polymorphism , on page 218). For example, if the list contains only 
FI oat values, we can use the following expression to retrieve a value. 

Float x = (Float)elem2.data; 

To recover a primitive f 1 oat value from its FI oat class counterpart we use 
float value = x.floatValue(); 

The other primitive types are similar; we make the obvious substitution for f 1 oat in f 1 oatVal ue (). If you 
don’t know what type of value is stored ina ListEl ement, Java provides the operator i nstanceof that you 
can use to test the type. (Recall our discussion of i nstanceof in Section 7.11, Type conversions and Polymor¬ 
phism , on page 218.) 

Now that we have a generic hst element, we can use it to create a generic list or a generic stack. Here, we 
make the change for the stack and leave the changes for the list for you to do as an exercise. In the following 
code, the changes are shown in italics. We replaced all occurrences of i nt with Object and all occurrences of 
IntListEl ement with Li stEl ement. The only other change was the name of the class—from Int Stack to 
Stack. 

//Stack.java 
class Stack { 

Object top() { 
if (top != null) 
return top.data; 
el se 

return null; 

} 

void push(Object value) { 
if (top == null) { 

top = new ListElementCval ue); 

} 

else { 

ListElement temp = new /_7st£7eff?ent(value) ; 
temp.next = top; 
top = temp; 

} 

} 

Object pop() { 

Object result - top(); 
if (top != null) 
top = top.next; 
return result; 

} 

boolean emptyO { return top == null; } 
private ListElement top = null; 


In the following program we use the new stack to store doubl e floating point values. 
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//CenericStackTest.java 
class GenericStackTest { 

public static void main(String[] args) { 

Stack stack = new Stack(); 

stack.push(l.Ill); 
stack.push(2.222); 
stack.push(3.333); 
while (!stack.emptyO) { 

double temp = (Double)stack.popO; 

System.out.println(temp); 

. } 

} 

} 

Notice that we take advantage of auto-boxing to convert the primitive double values into the object Double 
values in the calls to push() (see Section 7.11.2, Automatic Boxing of Primitives, on page 220). The Java com¬ 
piler determines that a primitive has been used were an Object is expected and does the boxing for us. We 
didn’t have to first store the popped value in temp. We did so merely to show how to convert the popped 
value to a primitive value of type doubl e. The same output would be obtained if the body of the loop was 
simply 

System.out.println(stack.pop()); 

The output of this program is 


3.333 
2.222 
1. Ill 


Common Programming Error 

When implementing linked list data structures, you must take great care to ensure that you always cre¬ 
ate proper linked lists. For example, you could create a circularly linked list that has no beginning or 
end. That’s fine, if that’s what you intended; but if your intent was a linear linked list, operations such as 
hasNext () may never return f al se. Then an innocent loop such as 

while (list.hasNextO) { 

... = list.next(); 

• mm 

} 

becomes an infini te loop. 


One good defense against such errors is the use of assertions, either formal or informal. A formal assertion is 
one that you actually place in the code to be checked. If the assertion fails, an exception can be thrown. An 
informal assertion can be in the form of a co mm ent that should be checked by the implementer of the 
method. 

An example of an assertion on the insert method for a hst might be “The next field for the last element in the 
hst is null.” As discussed in Section 11.1.6, Program Correctness: Throwing an Exception, on page 335, just 
the process of thinking about the assertions you might write can result in better code. For example, consider 
writing the assertion that the last element in the hst is null. Y ou should realize that you need to be sure that 
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the first element Inserted in an empty list and an element inserted at the end of a list must have their next 
fields set to null. 

Another way to avoid problems resulting from errors in implementing your own list class is to use an exist* 
ing list class that has been thoroughly debugged. Java includes an extensive collection of classes for handling 
hsts, stacks, and related structures. These classes are included in the package j ava .util. For example, there 
is a class java.uti 1 . LinkedList. Another is java.uti 1 .ArrayLi st which was discussed in Section 5.13, 
The container ArrayListo, on page 150. 



12.6 AN EXAMPLE: POLISH NOTATION AND STACK 

EVALUATION 


Ordinary notation for writing expressions is called infix , wherein operators separate arguments. Another 
notation for expressions, which is very useful for stack-oriented evaluation, is called Polish, or parenthesis- 
free, notation. In Polish notation the operator comes after the arguments. Thus, for example, 

3,7,+ is equivalent to the infix notation 3 + 7 

In Polish notation, going from left to right, the operator is executed as soon as it is encountered. Thus 
17, 5, 2, *, + is equivalent to 17 + (5 * 2) 

A Polish expression can be evaluated by an algorithm using two stacks. The Polish stack contains the Polish 
expression, and the evaluation stack stores the intermediate values during execution. The following 
two-stack algorithm evaluates Polish expressions wherein all operators are binary 7 . 

A TWO-STACK ALGORITHM TO EVALUATE POLISH EXPRESSIONS 

1. If the Polish stack is empty, halt with the top of the evaluation stack as the answer. 

2. If the Pohsh stack isn’t empty, pop the Polish stack into a variable called opval. 

3. If opval contains a value, push the contents of opval onto the evaluation stack. 

4. If opval contains an operator, pop the evaluation stack twice, first into b and then into a. Com¬ 
pute (a opval b) and push the result onto the evaluation stack. Go to step 1. 

We illustrate the use of this algorithm in the following table, where we evaluate the expression 

13, 4, 2, 3, *, + 


| ibpfjvljji 

Polish Stack 

Evaluation Si 

pack Comment 


13, 4, 2, 3, *, + 

Empty 

Initial configuration 

13 

4-23* + 

Empty 

Step 2 


4 - 2 3 * + 

* J ,4., 

13 

Step 3 

4 

-23* + 

f *- l 1 9 ~ 

13 

Step 2 


-23* + 

, 4. , J ’ 

4, 13 

Step 3 
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9 
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Step 2 
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Step 3 
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2, 9 
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Step 3 

* 

4 * 

3, 2,9 

Step 2 


+ 

6, 9 

Step 4 

+ 

Empty 

6,9 

Step 2 


Empty 

15 

Step 4 


Next, we write a program that implements this two-stack algorithm and test it with an evaluation of the Pol¬ 
ish expression 16, 9, *, 3, 7, +, +. We represent each element of the expression as a string. 

//Polish.java - two stack Polish evaluation algorithm 
class Polish { 

public static void main(String[] args) { 

String[] expression = {"13”, "4”, ”2", 

Stack stack = new Stack(); 

Stack intArguments = new StackQ; 

String opval; 

for (int i = expression.length - 1; i >= 0; 

stack.push(expression[i]); 
while (! stack.emptyO) { 

opval = (String)stack.popO; 
if (!isOperator(opval)) 
intArguments.push(opval) ; 
el se 

intArguments.push(eval(opval, intArguments)); 

} 

System.out.println(" = " + intArguments.top()); 



static boolean isOperator(String s) { 

return s .equals(’V) || s.equals("*") || s.equals( ,r -") ; 

} 

// apply a binary operator to the top two operands 
// on the stack 

static String eval(String operator, Stack stack) { 

String a, b; 

b = (String)stack.popO ; 
a = (String)stack.pop(); 
if (operator.equals('V')) 

return String.valueOf(Integer.parselnt(a) + Integer.parselnt(b)); 

else if (operator.equalsC'-")) 

return String.valueOf(Integer.parselnt(a) - Integer.parselnt(b)); 
el se 

return String.valueOf(Integer.parselnt(a) * Integer.parselnt(b)); 

} 

} 


By using code that has already been written and tested, such as Stack in the preceding example, you have 
less work to do in implementing a program to evaluate a Pohsh expression. 
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12.7 QUEUES 


A queue is a representation of a list of values for which the normal mode of operation is to insert objects at 
one end and remove them from the other. In the United States, people stand in lines to gei into a theater or 
check out at a store. In England these lines are called queues. People enter at the tail and leave from the head. 
A queue is a first-in-first-out (FIFO) data structure. In contrast, the stack we discussed earlier is a 
last-in-first-out (LIFO) data structure—the last value pushed in is the first value popped out. 

As with a stack, a queue can be implemented with an array or as a linked list of elements. Here we present a 
generic queue based on our generic class Li stEl emerst, which is similar to the class Stack. However, instead 
of push(), top(), and pop(), we have add(), which adds an element at the front, front (), which returns 
the element at the front of the queue, and pop () , which removes the element from the front of the queue and 
returns it. Also the class maintains two pointers—one to the head, or first element, and one to the tail, or last 
element. Recall that the stack had only one pointer, which referred to the top element. 

//Queue.java 
class Queue { 

Object front() { 
if (head != null) 
return head.data; 
el se 

return null; 

} 

void add(Object value) { 
if (head == null) { 

head = tail = new ListElement(value); 

} 

else { 

tail.next = new ListElement(value); 
tai1 = tai1.next; 

} 

} 

Object pop() { 

Object result = frontQ; 
if (head != null) 
head = head.next; 
return result; 

} 

boolean emptyO { return head == null; } 
private ListElement head = null; 
private ListElement tail = null; 

} 

Our program to demonstrate the use of Queue is almost identical to the one we used for Stack. The main dif¬ 
ference is in the output. This program prints the values in the order they are added to the queue. The output 
is 


1.111 
2.222 
3 . 333 
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//QueueTest.java 
class QueueTest { 

public static void main(String[] args) { 
Queue queue = new QueueO; 

queue,add(l.Ill); 
queue.add(2.222); 
queue.add(3.333); 
while (iqueue.emptyQ) { 

double temp = (Double)queue.popO; 
System.out.println(temp); 

} 

} 

} 



12.8 ITERATORS 


An iterator is a constiuc t that allows you to iterate over a collection of objects such as a list or an array. Any 

integer \ aiiable can lx used as an itei atoi for an array. It is often useful to be able to main t ain more than one 

iterator simultaneously for a single collection of objects. For example, using one forward iterator and one 

backward iterator you can reverse the elements in a list, implemented as an array, as shown in the following 
example. 

int foward = 0, backward = list.length - 1; 
while (forward < backward) { 
int temp = 1ist[forward]; 

1ist[forward] - list[backward]; 
list[backward] = temp; 
forward++; 
backward--; 

} 

There are two iterators in this example: forward and backward. Because arrays are a fundamental type in 
Java and many other programming languages, there is a built-in syntax for iterators that iterate over arrays. 

Two things are required of an iterator. You need some way to advance the iterator and fetch the next value. 

\ ou also need some wax to determine when you ve iterated over the entire collection. For an array, increment 

or decrement the index variable and then test it to determine whether you’ve reached the end or the begin¬ 
ning of the array. 


U hat about an iterator for classes such as Li st or Stack described in this chapter? The classes that imple¬ 
ment singly linked lists have one implicit iterator built into the class. You can use the method next () to iter¬ 
ate over all the elements of such a list and the method hasNext() to detect when the entire list has been 
scanned. The following example involves the use of this implicit iterator to iterate over the entire list. 

IntList list; 

// code to fill the list would go here 
1ist.moveToHead(); 
while (list.hasNextQ) { 
int value = list.nextQ; 

// do something with value 

} 

Using this implicit iterator, you can’t maintain two simultaneous iterators moving at different times or in dif¬ 
ferent directions. However, you can create a separate class to implement an iterator for a class such as Li st. 
The simplest iterators have only the two methods nextQ and hasNextQ. 
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In general, an iterator class will be aware of some details about how a collection is implemented. For the class 
IntLi st, the iterator class needs to know that the hst is stored as a linked hst of IntLi stEl ement objects. 
The standard way to create an iterator is to ask the class over which the iteration will occur to create one. 
This method is typically called iteratorC) in Java. Here is the new i terator() method for the class 

IntList. 

IntListlterator iteratorO { 

return new IntListlterator(this); 

} 

Ah this method does is create an IntLi stlterator object passing it a reference to the hst. The following 
implementation of the iterator class requires that the field head in the class IntLi st be changed from pri¬ 
vate to package access (see Section 12.11.1, Package Access , on page 381) and that aiul 

IntLi st be in the same package. 

// IntListlterator.java - simple forward iterator 
class IntListlterator { 

// Create an iterator positioned before the first 

// element of the list. 

IntListlterator(IntList list) { 
current = nul1; 
this.list = list; 

} 

// Create an iterator positioned at element pos. 

IntListIterator(IntList list, IntListElement pos) { 

// pos must refer to an element in list 
current = pos; 
this.list = list; 

} 

//Same as next() in IntList. 

int next() { 

if (current == null) 
current = list.head; 
el se 

current = current.next; 
return current.data; 

} 

//Same as hasNextO in IntList. 

boolean hasNextQ { 
if (current != null) 

return current.next != null; 

el se 

return list.head != null; 

} 

int currentO { 

return current.data; 

} 

IntListlterator copyO { 

return new IntListlterator(1ist,current); 

} 

IntListElement current; 

IntList list; 


} 
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Using this class you can now have as many forward Iterators at the same time for a hst as you want. Suppose 

that you want to determine whether a hst is in fact composed of two identical shorter lists concatenated 
together. The following method checks for this condition. 

//IteratorExample.java 
class IteratorExample { 

static boolean checkDuplicate(IntList list) { 

// count the number of elements in the list 
int numElements=0; 

IntListlterator iterator = list.iteratorQ; 
while (iterator.hasNextQ) { 
iterator.next(); 
numElements++; 

} 

// check for an even number of elements 
if (numElements%2 != 0) 
return false; 

// now compare the first half with the second half 
IntListlterator first = list.iteratorQ; 

IntLi stlterator second = list.iteratorQ; 

// advance second to the start of the second half 
for (int i =1; i <= numElements / 2; i++) 
second.nextQ; 
while (second.hasNextQ) 

if (first.nextO != second.nextQ) 
return false; 
return true; 

} 

} 

In the next example, involving two methods, we show how you can use iterators to process a list recursively. 
You can add these two methods to the class IntLi st. The first method simply creates an empty 7 hst and calls 
a private helper method to do the copy. 

static IntList copy(IntListlterator iter) { 
return new IntListQ .copyHelper(iter) ; 

} 

The second method is the recursive helper method. 

private IntList copyHelper(IntListlterator iter) { 
if (iter.hasNextQ) { 
insert (iter. nextQ) ; 
return copyHelper(iter); 

} 

el se 

return this; 

} 




Dissection of the Method copyHel per () 


• if (iter.hasNextQ) { 

This test is t or the base case of the recursion, which occurs when the iterator has been advanced over all 
elements and there are no more elements to process. 
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• i nsert(i ter. nextO) ; 
return copyHelper(iter); 

If there are more elements to be copied, we insert the next element from the list being copied into this 
IntLi st object, which is the copy. Recall that the static method copy () created a new IntLi st object, 
which is the copy. The method copyHel per() operates on this new IntLi st object. After inserting the 
next element in the copy, we recursively call copyHel per (), which eventually returns a reference to 
this, after all the elements have been copied. 

# else 

return this; 

When all the elements have been inserted in the copy, which is the object referred to by thi s, the 
IntLi st object being operated on by copyHel pe r () simply returns a reference to the copy. This action 
causes all the recursive calls made in the repeated executions of the statement 

return copyHelper(iter); 

to return also. 



1 2.8.1 USING ITERATORS TO IMPLEMENT THE METHOD append() 

Let’s implement the method append () for the class IntLi st. This method appends all the elements of one 
hst to the end of another list. We present three different versions. Our first solution doesn’t take advantage 
of any iterator methods. Our second solution uses the existing built-in iterator in IntLi st. The third solution 
shows how iterators can be used to create a simple implementation of append (). 

In the first solution, which doesn’t use the other methods in IntLi st, the built-in iterators for the two lists 
aren’t repositioned. 

void append(IntList list) { 

IntListElement thisList = head; 

IntListElement otherList = list.head; 

IntListElement previous = null; 

// Position thisList on the last element by advancing it off the end 
// and then backing up one. After the loop, previous will point to the 
// last element or be null if the list is empty, 
while (thisList != null) { 
previous = thisList; 
thisList = thisList.next; 

} 

thisList = previous; 

// Loop over the other list and insert each element 
// onto the end (pointed to by thisList). 
while (otherList != null) { 

// do the insert 

thisList.next = new IntListElement(otherList.data); 
thisList = thisList.next; 

// move to the next element of other list 
otherList = otherList.next; 

} 

} 

Use of the higher-level operations provided by a class is preferable, even when we’re adding additional meth¬ 
ods to a class. Their use minimizes the number of methods that must change in response to some low-level 







































12.8.1 Using iterators to implement the method append() 377 

implementation detail change. The following code is a first attempt at the second solution, which uses the 
existing routines from the class IntLi st. 

void append(Int!_ist list) { 

// Position first list’s built-in iterator on its 
// last element, 
while (hasNextO) 
next(); 

// Position the second list’s built-in iterator on 
// its first element. 
list.moveToHeadQ ; 

// Add each element from the second onto the end 
// of the first, 
while (list. hasNextQ) 
insert(list.nextO) ; 

} 

The problem with this code is that it changes the value of the field current for both lists. Such a change is 
probably unexpected by the programmer using append () , particularly the change in cur rent for the exphcit 
parameter 1 i st. To resolve this problem, we can save both cu r rent and previ ous for both lists and then 
restore them before the method returns, as in 

void append(IntList list) { 

// Save positions of built-in iterators. 

IntListElement saveCurrent = current; 

IntListElement savePrevious = previous; 

IntListElement listCurrent = list.current; 

IntListElement listPrevious = list.previous; 

// Position first list’s built-in iterator on its 
// last element, 
current = head; 

while (hasNextO) 

next(); 

// Position the second list’s built-in iterator on 
// its first element. 
list.moveToHeadO ; 

// Add each element from the second onto the end 
//of the first. 
while (1 ist.hasNextO) 
insert(list.nextO) ; 

// Restore the built-in iterators, 
current = saveCurrent; 
previous = savePrevious; 
list.current = listCurrent; 
list.previous = 1istPrevious; 

} 

An even more robust solution is to use iterators. We first need to add a new method, i nsert (), that allows 
us to insert an element after the position indicated by an iterator. This method is similar to our current 
i nsert (), but instead of allowing insertion only after the single implicit iterator, we allow insertion after an 
arbitrary iterator. We leave the implementation of this new i nsert () for you to do as an exercise. Once 
we’ve added the new method i nsert () to the class IntLi st, we can implement append () as follows. 
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void append(IntList list) { 

IntListlterator thisList - this.iterator(); 

IntListlterator otherList - 1ist.iterator(); 

// Move iterator for first list to its last element. 

whi le CthisList.hasNextO) 
thisList.next(); 

// Add each element from the second onto the end of the first. 

while (otherList.hasNextO) 

thisList - i nsert(thi sLi st, otherList. nextQ) ; 


This last solution completely isolates the implementation of append () from the implementation details of 
the class IntLi st. This version of append () works for any list unplementation that has iterators and a 
method insertQ that takes an iterator and a value to insert. 


1 2,8.2 SORTING A LINKED LIST 

A simple sorting algorithm for linked lists is the insertion sort , which is similar to sorting a hand of playing 
cards by picking the cards up one at a time and placing each in its proper position. This isn’t an “in place” 
sort, meaning that we don’t modify the original list. Instead, we create a new list that is a copy of the original 
elements but in the proper order. In the following method to sort an IntLi st list, we use our original class 
IntLi st with the addition of a method to insert an element at a position specified by an iterator, as just dis¬ 
cussed. 


//IntListSort.j ava 
class IntListSort { 

static IntList sort(IntList list) { 

IntList sorted = new IntListO; 

IntListlterator listlter = list.iteratorQ ; 
while (listlter.hasNextO) { 

// select the next item to be inserted 
int newltem = 1istlter.next(); 

IntListlterator sortedlter = sorted.iterator(); 
IntListlterator previous = null; 

// loop until a bigger item is found in sorted 
while (sortedlter.hasNextO && newltem > sortedlter.next()) { 
previous = sortedlter.copyO ; 

} 

// insert before the bigger item which we do 
// by inserting after the element before it 
if (previous == null) // insert at head 
previous = sorted.iterator(); 
sorted.insert(previous, newltem); 

} 

return sorted; 

} 

} 




Dissection of the Class IntListSort 

# IntList sorted = new IntListO; 


We create a mew empty list that will eventually contain the elements from list, but in order, with the 
smallest elements first. 
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• IntListlterator listlter - list.iteratorQ; 
while (listlter.hasNextO) { 

We create an iterator and then examine each of the elements in 1 i st, using a whi 1 e statement. The body 

of the loop inserts the elements from 1 i st in the list sorted so that elements in sorted are always in 
nondecreasing order. 

% int newltem = listlter.next(); 

IntListlterator sortedlter = sorted.iterator(); 

IntListlterator previous = null; 

// loop until a bigger item is found in sorted 
while (sortedlter.hasNextQ && newltem > sortedlter.nextQ) { 
previous = sortedlter.copyO ; 

} 

We use two iterators to find the insertion point. The iterator previ ous is nul 1 until the loop body has 
been executed at least once. From then on, previous points to the element before the element pointed 
to by sortedlter. When the loop exits, previ ous points to the element preceding the insertion point or 
is null , in which case insertion should be done at the head of sorted. 

• if (previous == null) // insert at head 

previous = sorted.iterator(); 
sorted.insert(previous, newltem); 

We check for the special case of insertion at the head. To insert an element at the head we create a new 
iterator, positioned before the first element. Once previous has been set properly, we do the insertion. 




1 2.9 ITERATORS AND THE INTERFACE Iterator 


As we have shown, iterators need two methods: hasNextO and nextQ. The standard Java interface Itera¬ 
tor in the package java, util requires these two methods and a method remove(). 

Early versions of Java used an interface java, uti 1. Enumeration, which was logically equivalent to Itera¬ 
tor, but without the method remove(), The method names were slightly different: hasMoreEl ementsQ and 
nextElementQ. 

A class that implements the interface Iterator must include a method remove(), but the method isn’t 
required to actually remove the item indicated by the iterator. If the method remove () doesn’t remove the 
item, it should throw an UnsupportedOperati onExcepti on. 

i he use of this interface simplifies code that includes iterators: All loops that have iterators now become 
more alike. When combined with the stylistic use of the method i terator() to return an iterator for a con¬ 
tainer, many loops now take on the form 

Iterator i = container.iterator(); 
while (i.hasNextO) { 

SomeType local Variable = (SomeType)i.next(); 

// do something with localVariable 

} 

We used Iterator instead of some type-specific iterator class. Its use means one less class for the reader of 
the code to understand. The only disadvantage is that we may need to cast the result of next () to the appro¬ 
priate type. The specification of next() in the interface Iterator returns a value of type Object. As we 
have shown, this operation is safe in the sense that, if we attempt an illegal cast, an exception is thrown. 
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The interface Iterator is useful only for iterators that iterate over containers of nonprimitive values. The 
added overhead of wrapping a primitive type into a wrapper class and then unwrapping it is probably not 
worth it for containers such as our IntLi st from Section 12.3, A Singly Linked List , on page 361. The inter¬ 
face Iterator is useful when we’re working with generic containers. For example, the standard Java class 
Li nkedList has a method i teratorC) that returns an Iterator object that can be used to iterate over the 
elements in the Li nkedLi st. 



1 2.1 ODELETING OBJECTS 


We have shown how to create objects by using the keyword new. Each new object occupies some space in the 
computer’s memory. So what happens to objects that are no longer needed? In some programming lan¬ 
guages, notably C and C++, we have to explicitly tell the computer when certain data structures are no longer 
needed. In Java, the computer automatically figures out when an object is no longer needed and removes it. 
This procedure is called garbage collection . Using 1990s terminology 7 , it would be better named memory recy¬ 
cling r, but garbage collection was used to refer to this activity before the recycling of garbage became popular. 

How does the computer know when an object is no longer needed? It doesn’t, but it does know when the 
object can no longer be referenced by the program. If there are no legal references to an object, the memory 
allocated to the object can be recycled. Consider the following example. 

Scanner in = new Scanner(System.in); 

String word = in.nextO; 
while (!word.equals("quit")) { 

// do some processing with the word 
word = in.nextO ; 

} 

Each call to next() returns a reference to a new Stri ng object. At the end of each loop iteration, word refers 
to a new Stri ng object, losing the reference to the previous object. If the rest of the loop doesn’t create any 
additional references to the object referred to by word, the memory 7 for all but the last Stri ng object can be 
recycled. 

We don’t have space for an extensive discussion of garbage collection algorithms. But to give you some idea 
of how they work, we describe simplified approximations of two approaches. 

One way to determine if there are any legal references to an object is to locate all the variables in the active 
methods. A method is active if it has been called and hasn’t yet returned. For each of these variables that is a 
reference type, mark the object it refers to as live. Then examine each hve object and find the reference type 
variables in those objects and mark the objects they refer to as hve. Continue this process until no new 
objects are marked as hve. Any object not marked is garbage and can be recycled. This process, called mark 
and sweep garbage collection , is typically done when the computer begins to run low on memory. It can be 
time-consuming—possibly taking several seconds—which can be annoying to people using the system. 

Another approach is to count the references to a particular object as they are created. When a reference is 
overwritten, the count of references to the object is decremented. When an assignment results in a new refer¬ 
ence to the object, the count is incremented. When the count goes to zero, the object can be collected. This 
process is appropriately called reference counting , which doesn’t cause the delays of mark and sweep. 
Instead, it slows the entire system a bit all the time because all operations that can affect references must 
deal with adjusting the counts. 



1 2.11 PACKAGES 


Even the simplest java program uses classes that were written by others. This ability to reuse parts of pro¬ 
grams is essential for building complex software systems. Collections of functions, procedures, or classes are 
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often called libraries. Essentially all programming languages or their development systems provide some 
mechanism for a program to use these routines or classes. 

In Java, groups of related classes can be placed in a package. There are two primary reasons for organizing 

classes into packages. First, a field or method that is defined without any of the access modifiers—publ i c, 

protected, or pri vate— can be accessed only from a method in a class from the same package. Thus classes 

can expose some implementation details to other classes in the same package but not to classes outside the 
package. 

The second reason for using packages is to provide separate name spaces. This provision allows two differ¬ 
ent programmers or organizations to have classes with the same name and still use these classes in one pro¬ 
gram. For example, a software company that would like to define some of the standard mathematics 
functions slightly differently could create its own class Math. It should be placed in a package with a name 
derived from the company’s name because part of the Java specification is a naming scheme for packages. 
This scheme is somewhat like Internet addresses in reverse, with the most general part of the name first. So a 
company with the Internet address www.coolsoft.com might name its package containing the class Math 
com. cool soft. general . If the CoolSoft Corporation had a collection of classes that it used for handling 
standard container data structures, it might put them in a different package called com. cool soft. contai n- 
ers. Tins package might have classes with some of the same names as those in the standard Java package 
java, uti 1. For example, finding a better name than Stack for a class that implements a stack is difficult. 
There is already a class named Stack in j ava .util. Without packages to provide different name spaces, you 
couldn’t write a program using com. cool soft. contai ners . Stack in one place and java, uti 1 . Stack 
somewhere else. 


12.1 LI PACKAGE ACCESS 


As mentioned, a primary 7 reason for using packages is to allow a group of classes to share methods and fields 
but not allow those methods or fields to be accessed from outside the package. In addition, a package can 
contain entire classes that aren’t visible outside the package. We’ve already shown how the modifier private 
can be used to hide implementation details inside a class. In the same way, package access hides implemen¬ 
tation details inside a package. Package access is the default obtained by not specifying any access modifier. 
.Another access level that we’ve used is publ i c, the access modifier that must be used for any classes, meth¬ 
ods, or fields that are to be made visible or exported from the package. In the following example we modified 
IntLi stElement, IntStack,‘and IntLi st to create a package i ntContai ners that exports the two classes 
IntStack and IntLi st. Only the parts that we changed are shown. The missing portions can be filled in 
from the earlier examples in this chapter. 

// IntListElement.java 
package intContainers; 

class IntListElement { 

// omitted 

} 


// IntStack.java 
package intContainers; 


public class IntStack { 
public int top() 
public void push(int value) 
public int pop() 
public boolean emptyO 

} 

// IntList.java 
package intContainers; 


// body omitted 
// body omitted 
// body omitted 
// body omitted 
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public class IntList { 

public void insert(int value) 
public int nextQ 
public void removeO 
public void moveToHeadO 
public boolean hasMextC) 
private IntListElement head, 


// body 
// body 
// body 
// body 
// body 
current, 


} 


omitted 
omitted 
omitted 
omitted 
omitted 
previous; 


We added the keyword publ i c to all the methods in IntLi st and IntStack. We also added it to the class 
definitions for those two classes. Note that the class IntLi stEl ement isn’t public. It has package access, 
specified by the absence of either private or publ i c. Package access prevents IntLi stEl ement from being 
used outside the package. The class IntLi stEl ement is an implementation detail that shouldn’t be visible 

outside the package. 


12.11.2 USING PACKAGES 

Let’s review how to use packages. Whenever you want to use a class from an existing package, you need to 
use an import statement to i mport the class. For simplicity, you should usually import all the classes from a 
package with import statements such as 

import java.util.*; 

This statement imports all the classes in the package java. uti 1 . The “*” is called a wildcard, meaning “give 
me all the classes.” You can also import specific classes. For example, 

import java.uti1.Scanner; 

Another alternative is not to use an i mport statement but instead always spell out the full name of the class. 
It is called the qualified name and includes the package name. This option can be rather awkward and isn’t 
recommended if you intend to use the name of the package more than once. For example, you could use the 
following create a Scanner for reading from the console. 

java.uti1.Scanner in = new java.uti 1 .Scanner(System.in); 

The import statement told the compiler that if it encountered a class name it didn’t recognize, it should try 
looking for it in the imported package. Import statements can save a lot of typing. 

This explicit naming mechanism makes the use of two different Math classes possible. Here is how you could 
use the class Math from CoolSoft. 

double x = Math.sqrt(y); // from java.1ang 
double y = com.coolsoft.Math.sqrt(y); 

You don’t have to import the package java. 1 ang. It is imported by default into every Java class. That’s why 
we could write Math. sqrtQ, which uses the class Math from package java. 1 ang, without having to use an 
import statement. The package java. 1 ang is the only package that is automatically imported. 


1 2.1 1.3 ■ CREATING PACKAGES 

Every Java program can use classes from one unnamed package. .Any classes in a single directory on your 
computer’s disk that don’t specify a package name are part of the same unnamed package. To place the 
classes in a named package, you need to do two things: add a package statement to the top of each class in 
the package as shown in the preceding example, and place the classes in an appropriately named location on 
your computer’s disk. For the i ntContai ners package that we introduced, you need to place the source files 
in a subdirectory with the same name as the package, intContainers . If you’re using a Unix or W indows com¬ 
mand lin e to compile your Java programs, then with your current directory set to the one containing the sub¬ 
directory intContainers, execute the command 
















javac intContainers/*.java 


Note that the current directory is not intContainers but the one containing the subdirectory intContainers. 

ta S j COnmaaC * com P^ es thf J ava source files in the subdirectory. The command shown is for Unix. On 
u mdows \ ou would use a instead of a “/” to separate the subdirectory from the wildcard file name. If 

^i? U J? us 3 ng 311 integrated development environment, you’ll probably have to create a project that includes 

the files from the package and then compile them. A project is the term used by most integrated develop¬ 
ment environments for a group of related files. 

By default, Java looks for packages in the directory where Java was installed and then looks for packages in 
the current working directory. You can change this procedure by changing the CLASSPATH environment vari¬ 
able. Check with your instructor or read the documentation for your system to determine the appropriate 
way to make this change. For small projects this change usually isn’t necessary. 
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Code reuse is the practice of reusing existing code in new programs. It has been an important part of pro¬ 
gramming from the beginning, but the amount of reuse is increasing. The complexity of current applications 
requires code reuse because it reduces development time and improves reliability. Increased reliability, in 
general, is the result of thorough testing of the reused components. 

There are two aspects of code reuse: creation of reusable components and use of those components. One of 
the strengths of Java is the large and growing collection of reusable components called classes and collected 
as packages. In this chapter we introduced some basic data structures. You need to know how these data 
structures are created. When building real applications, you should, in general, not reimplement these basic 

data structures. Instead, you should select some appropriate reusable class or package that provides the 
f unctionality that your application needs. 

if you determine that the performance of a class from a preexisting package is inadequate for your applica¬ 
tion, you should be able to replace that package easily with an implementation of your own. 

The standard Java classes include several useful containers, such as Li nkedLi st, and Stack, in the package 
java.util. 



Summary 


• Self-referential structures use references or pointers to link items of the same type. 

® The simplest self-referential structure is the linear or singly linked list. Each element points to the next 
element, with the last element having a link value of null. 

• Many list processing algorithms are naturally implemented recursively. Frequently, the base case is when 
the end of the list is reached. The general case recurs by mo ving to the “next” element. 

• The abstract data type (ADT) stack is implementable as a linked list, with access restricted to its first ele¬ 
ment, called the top. The stack has a last-in-first-out (LIFO) discipline implemented by the routines 
push() and pop(). 

• g he ADT queue is also implementable as a linked list, with access restricted to its front and rear ends. 
The queue has a first-in-first-out (FIFO) discipline implemented by the routines add() and pop(). 


A doubly linked hst has a link to the next and preceding elements. Having both forward and backward 
links facilitates some list operations. 
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H Generic list structures can be created by having the list elements store a reference to an Object. Any 
nonprimitive type can be stored directly in such an element. The wrapper classes from j ava. 1 ang m 
conjunction with auto-box/unbox can be used to store primitive values in such a list. 

H Iterators are used to iteratively process all the elements in a container, such as a list. An iterator at the 
very least needs the two methods next() and hasNextC). 

% A group of related classes can be placed in a package. By doing so, you can expose some implementation 
details to other classes in the same package without making them generally accessible. Packages also 
provide for distinguishing between two classes with the same name but from different packages. T s 
provision allows both classes to be used if desired in a single program. 



Review Questions 


1. What causes a Nul 1 Poi nterException? 

2. What is the default value for reference fields? 

3. Draw a picture of a singly linked list containing the values 10, 20, and 30, in that order. 

4. Draw a picture of a doubly linked list containing the values 10, 20, and 30, in that order. 

5. A stack is used to process data in what order, LIFO or FIFO? 

6. A queue is used to process data in what order, LIFO or FIFO? 

7. What standard Java type is used to turn a primitive i nt value into an object? Why would you want to do 
that? 

8. Why would you need an iterator for IntLi st when it already has methods hasNextC) and next O'? 

9. IntLi st could have been implemented without the field previous. What operation would have been 
slowed down significantly if previ ous weren’t used? 

10. Name one operation that would be much faster on a doubly linked hst than a singly linked list. 

11. How is package access specified? What does it mean? 

12. What was wrong with using the implicit iterator in IntLi st to implement append () as shown in 
1 Section 12.8.1, Using Iterators to Implement the method append ft on page 377? 

13. Each time a method is called, some context such as the value of local variables and the address oi the last 
statement executed must be saved. When the called method returns, the context of the method that did 
the call is restored. What data structure is used to store these contexts? (Hint Think about methodAQ 
calling methodBQ calling methodCO and then each returning in turn.) 

14. If you wanted to write a computer program to simulate a bank teller, what data structure would you use 
to store the objects representing each simulated customer as he or she arrives at the bank? 
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Exercises 

1. Write an Insertion method that inserts an element before the first element of an IntLi st list. 

2. Write an insertion method that inserts an element after the last element of an IntLi st list. 


3. Write an insertion method that inserts an element at the first position in an IntLi st list following an 

element storing a particular data value. If there is no such element, insert the element after the last ele¬ 
ment. 


4. Generalize the previous three exercises. Write an insertion function that inserts an element in the nth 

position in a list, where 0 means that the element is placed at the head of the list. If n is larger than the 
length of the list, insert the element at the tail of the list. 

5. Modify the method next Q in the class IntLi st to throw a NoSuchEl ementExcepti on if there is no next 
element. The syntax for throwing the exception is 

throw new NoSuchElementExceptionQ ; 

6. Add a constructor to the class IntLi st that takes an array of integers and uses the array to build an ini¬ 
tial list. The elements in the list should be in the same order as the elements in the array. 

7. Add a method toIntArrayO to the class IntLi st that returns a new array of integers containing the 
same elements as the list, in the same order. 

8. Write a class that implements the same methods as IntLi st but represent the list as an array of inte¬ 
gers. Add a constructor that allows the programmer to specify the maximum size of the list. Use this 
constructor to set the size of the internal array. 

9. Write a class List that can store a list of any nonprimitive type values. Start with IntLi st and make the 
same changes that were made to create the generic class Stack. 

10. Create a class Data that contains two integer fields—one for age and one for weight—and one string field 
for a name. Build a list of Data objects, using Li st from the previous exercise. Then write a method to 
count the number of objects in the list that have age and weight fields above a given value. 

11. Write a class IntDLi st that uses the IntDLi stElement defined in Section 12.4.2, Doubly Linked Lists, on 
page 366. Include methods for insertion and deletion and a method toSt ri ng (). 

12. Add a method removeDupsQ to your class IntDLi st in the previous exercise. The method removes 
from the list, elements having duplicate values. 

13. Write a class DLi stEl ement that is a generic list element, similar to Li stEl ement, but doubly linked. 

14. Use the DLi stEl ement of the previous exercise to implement a class DLi st with methods that function 
like those in IntLi st. 

15. Add the method previ ousEl ement O to the class DLi stEl ement in the previous exercise. 

16. Write a program that uses the class Stack to reverse the words in a sentence. The sentence to be 
reversed should be read with Scanner. next(). Use Scanner. hasNextO to check for the end of the 

input. Use lastlndexOfO and substring() from the class String to remove the period at the end of 
the last word of the sentence. 

17. Add a method concatenate(IntLi st list) to the class IntLi st. This method doesn’t copy the ele¬ 
ments of 1 i st, as does append (); instead, it simply sets the field next of the last element in the list 
referred to by thi s to point to the first element of the list referred to by 1 i st. Draw a diagram of the list 
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that would result from 1 i stOne. concatenate(1 i stOne), where li stOne refers to a list of two ele¬ 
ments. What happens if the resulting list 1 i stOne is printed, using the method toStri ng() from Section 
12.4.1, Implementing the Method toStringO for the Class IntList, on page 366? 

18. In the previous exercise you constructed a cycle. A cycle is a pointer chain that points back to itself. 
Cycles are particularly nasty run-time bugs that can be hard to recognize. Add a method i scycl e() to 
the class IntLi st that returns true if a cycle is detected and fal se otherwise. ( Hint. Save a reference to 
the initial element of the list and follow the links until either null is reached or the initial element is 

encountered.) 

19. Modify concatenate Q in Exercise 17 to throw an I'll egalArgumentExcepti on if the result of the oper¬ 
ation would create a cycle. Don’t do the concatenation in that situation. The exception 111 egal Argumen- 
tException is defined in the package java. 1 ang. 

20. Add a static method copyCat(IntList a, IntList b) to the class IntList that returns a concate¬ 
nated copy of the lists a and b. The original lists a and b should remain undisturbed. This method should 
work fine if called with both arguments referencing the same list. 

21. Add a method insert(IntListlterator iter, int value) to class IntList. The method inserts a 
new element with the field data set to val ue, following the element referred to by the iterator i ter. The 
method should return a new IntLi stlterator, positioned at the element just inserted. Note that an 
iterator not pointing to any element (current == null) should be interpreted as positioned before the 
first element. This interpretation allows for insertion at any point. The iterator can’t be positioned after 

the last element. 

22. Using the iterator class IntLi stlterator, add a method with the signature 

static IntList concatenate(IntListlterator indexl, IntListlterator index2) 

to the class IntLi st. This method should return a new list that is the result of concatenating copies of 
the elements starting from i ndex2 to a hst made from copies of the elements starting from i ndexl. 

Write an iterative solution. 

23. Use recursion to redo the previous excercise. 

24. Starting with a linked hst of objects as specified in Exercise 10, write a routine sortAgeO to sort the hst 
according to its age values. Write a function sortNameO to sort the hst in lexicographic order according 

to the name values. 

25. Evaluate the following Polish expressions by hand. 

7, 6, 3, * 

9, 2, 3, *, 4, -, + 

1, 2, +, 3, 4, +, 

26. Write corresponding Polish expressions for 

(7+8+9) * 4 

(6 - 2) * (5 + 15 * 2 

6 - 2 * 5 + 15 * 2 

27. Use the Polish program that we wrote in Section 12.6, An Example: Polish Notation and Stack Evaluation , 
on page 371, to evaluate the six Polish expressions given or derived in the previous two exercises. 

28. The following lines occur in the eval () function in the class Polish: 

b = (String)stack.pop(); 
a = (String)stack.popO ; 


What happens if you write 
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a - (String)stack.popO ; 
b = (String)stack.popO; 

instead? The program should work properly on some Polish expressions but not on others. Explain why. 

29. Write a routine that allows you to interactively initialize the contents of a Pohsh stack. Write a program 
to test your routine. 

30. Add a constructor to the class Queue that builds a queue from an array of objects. 

31. Add a method toArrayQ to the class Queue that returns an array containing the same elements as the 

Queue. Did you copy the elements into the new array or just the references to the elements? Discuss the 
two alternatives. 

32. Use a general linked hst structure to program sparse matrix addition. In a sparse matrix most of the val¬ 
ues are zero. A nonzero element of a sparse matrix is represented by the triple O', j, value). For each row z, 
the triples will be linked as a linear hst. There will be an array with as many entries as there are rows in 
the matrix. Each array entry will be the hst for the corresponding row. To add matrix A to matrix B, we 
take each row in the two matrices and merge them into a matrix C. For each row index, if only one matrix 
contains elements for that row, that row is duphcated in C. If both matrices contain elements for a given 
row, the rows are merged. If both rows have a triple with the same column value, in the output row cy is 
the sum a f + b Otherwise, the element with smallest col umn number becomes the next element of the 
output row 

33. Although sparse matrix addition can be performed with just row linked lists, for multiplication both 
row- and column-linked lists are required. You won’t be able to use the hst classes developed in this 
chapter. Each element can potentially have both a row successor and a column successor. If the elements 
are implemented by the class SME1 ement, there will be two SMEl ement arrays—one for the rows and one 
for the columns. Each nonnull array entry in the row array will be a link to the first nonzero row entry. 
The columns are handled similarly. Program sparse matrix multiplication. 

34. Implement a sparse polynomial class. Use a linked hst of elements to represent the nonzero terms of the 
polynomial. A term is a real coefficient and a power. Write a complete polynomial manipulation package. 
Your package should be able to input and output polynomials, and it should be able to add, subtract, 
multiply, and copy polynomials. 
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Some progra mmin g problems can most naturally be represented as a collection of distinct tasks to be per¬ 
formed concurrently. In some cases, the concurrency is obvious and unavoidable, as when two computers 
communicate over a network. For example, fetching a file over the Internet involves the task of reading the 
file from the network on one computer and the task of writing the file to the network from a different com¬ 
puter. In other cases, all the tasks may execute on one computer, in which case concurrent execution may 
only be desirable, not required. For example, suppose that you were asked to design and implement a new 
Internet browser. Among other things, you might want the browser to be able to load large graphics files in 
one window while you simultaneously followed several other links in another window. The computer is 
essentially being asked to do two things at once. Most operating systems today provide some support for 
doing several things at once, but support in popular languages was limited or nonexistent prior to Java. 


Many different terms are applied to a unit of sequential program execution that is executing within a com¬ 
puter system that is executing many such units simultaneously. The largest unit is usually called a process. A 
process is the term for a program when it is executing. Most operating systems support concurrent execution 
of multiple processes. To grasp the difference between a process and a program, consider that you could 
have two different processes, each executing the same program. 

The other terms most commonly used for units of sequential execution are tasks and threads , both of which 
generally refer to the execution of less than an entire program. This is in contrast to process, which usually 
refers to the execution of an entire program. Java provides language support for concurrent execution of 
parts of programs called threads. Three fundamental capabilities must be provided to support concurrent 
programs or threads. 


• Concurrency—There must be some way to create multiple execution threads. 

• Synchronization—There must be some way for two threads to synchronize in order to avoid interfering 
with each other. 

• Communication—'There must be some way for two threads to exchange information. 


In this chapter we describe how each of these capabilities is handled in Java. 
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1 3.1 IMPLICIT THREADS FROM AWT 


Programs that use AWT or Swing to create graphical user interfaces implicitly create a concurrent thread to 
respond to input events and call the appropriate event hsteners. We can get a clear sense of the two threads 
by having our method mai n O do something after creating the components of a GUI. The following Program 
increments a count once a second, while at the same time responding to simple button clicks in a GUI. e 
program has three classes. The class AwtTh read contains mai n (), which starts the GUI and then loops, plant¬ 
ing count once per second. The class Cl i ckCounter is a simple Acti onLi stener that counts the number of 
times the button it is listening to is chcked. The class GoodBye is a simple Acti on Li stener that exits when 
the button it is liste nin g to is chcked. We discussed GoodBye in Section 8.2, Listening to Events , on page 231 

and don’t repeat it here. 


//AwtThread.java - doing two things at once 
import java.awt.*; 
import javax.swing.*; 


class AwtThread { 

public static void main(String[] args) throws InterruptedExceptton { 

createGUIO; 
int count = 0; 
while (true) { 
count++; 

// go to sleep for 1 second = 1000 milliseconds 
Thread. currentThreadO . si eep(1000) ; 

System.out.println("count is now " + count); 

System.out.flushQ; // force output to print now 

} 

} 

static void createGUIO { 

JFrame frame = new 3Frame("AwtThread"); 

Container pane = frame.getContentPaneO ; 

JButton quit = new 3Button(”Quit"); 
quit.addActionListener(new GoodBye()); 
pane.add(quit, BorderLayout.NORTH); 

IButton counter = new JButton("Click to count"); 

counter.addActionListener(new ClickCounter()); 

pane.add(counter, BorderLayout.SOUTH); 

frame.pack(); 

frame.setVisible(true); 

} 

} 

//ClickCounter.java - count button clicks 
import java.awt.event.*; 

class ClickCounter implements ActionListener { 
public void actionPerformed(ActionEvent e) { 
count++; 

System.out.println("Total clicks is " + count); 

} 

int count = 0; 

} 

Earlier when we discussed GUIs we never did any processing in mai n() after building a GT I. All computation 
was driven by events. If you rim the preceding example, you’ll see that a window appears with the two but¬ 
tons Qui t and Cl i ck to count. When you click the counter button, the number of clicks is printed. No mat- 
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ter what you do, about once a second the variable count in mai n () is incremented and its value printed. You 
can go back and forth as much as you like. Actually, two threads are r unnin g. One is waiting for GUI events, 
and the other is executing mai n() with its whi 1 e statement. The thread reading the GUI events is created by 
part of the AWT code, but it uses the mechanisms we describe shortly. We discuss the method si eep() used 
in this example in Section 13.7.1, Calling sleepQ from Anywhere , on page 410. 
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1 3.2 CREATING THREADS 


A Java thread is represented by an instance of a class. The simplest way to create a thread that actually does 
something is to extend the class Thread from the package java. 1 ang. The following example creates two 
simple threads. Each prints a message periodically, using the method si eep() to control the speed at which 
it prints its messages. 

//TwoThreads.java - create two simple threads 
class TwoThreads{ 

public static void main(String[] args) { 

SimpleThread tl = new SimpleThread(l, 1000); 

SimpleThread t2 = new SimpleThread(2, 1300); 
tl.start(); 
t2.start(); 

} 

} 

The class SimpleThread implements the threads. The constructor for SimpleThread takes two parameters: 
an integer used to distinguish the threads and the number of milli seconds to delay between each message. 
The delays are chosen so that the threads progress at different rates. In much the same way that calling the 
setVi sibl e(true) method for a 3 Frame starts a thread inside AWT to listen for events, calling start () in 
this example starts a thread that is executing the instructions specified by the class SimpleThread. 

//SimpleThread.java * periodically print a message 
class SimpleThread extends Thread { 

SimpleThread(int threadld, int threadDelay) { 
id = threadld; 

delay = threadDelay; // in milliseconds 

} 

public void run() { 

System.out.println("Thread" + id + " started.”); 

System.out.flush(); //needed to see the effect 
for (int i = 0 ; i < 10 ; i++) { 
try { 

sleep(delay); // sleep delay milliseconds 

} 

catch (InterruptedException e) { 

System.out.println("sleep interrupted: ”+e); 

} 

System.out.println(”Thread" + id + ": i = " +i); 

} 

System.out.println("Thread” + id + " finished."); 

} 

private int id; 
private int delay; 

} 
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Dissection of the Class SimpleThread 


# class SimpleThread extends Thread { 

The class Thread is from the package java. 1 ang. The class Thread implements most of the functional¬ 
ity required to have a separate thread. All we need to do is override the method run (). This is a powerful 
use of inheritance. 

# SimpleThread(int threadld, int threadDelay) { 

id = threadld; 

delay = threadDelay; //in milliseconds 

} 

We use the constructor to initialize a simple i d variable used to distinguish the messages in the output. 
The variable delay controls the rate at which messages are printed. 

H public void run() { 

mm* 

} 

The method run () must be overridden to define the actions for this thread. This method is analogous to 
mai n () for the single threaded programs that we’ve been writing. The Java virtual machine eventually 
calls the method run() in response to a call to start () for an object that extends the class Thread. We 
don’t call run () directly because the Java virtual machine needs to create some internal data structures 
to handle the new execution thread. 

# System.out.println("Thread" + id + " started."); 

System.out.flush(); //needed to see the effect 
for (int i =0; i <10; i++) { 

try { 

sieep(delay); // sleep delay milliseconds 

} 

catch (InterruptedException e) { 

System.out.println("sleep interrupted: + e); 

} 

System.out.printlnC’Thread" + id + M : i = +i); 

} 

System.out.printlnC’Thread" + id + ” finished."); 

When the thread starts, we print an appropriate message. The method f 1 ush() forces the output to 
come to the screen. Without this method, the system might buffer the output for later display. We then 
loop 10 times, printing a message each time around the loop. To control the rate of execution, we use i he 
method si eep(), which is inherited from the class Thread. The parameter or si eepQ is the number of 
milliseconds that the thread should be put to sleep. At the end of the delay, the thread will be awakened 
and continue executing. This technique is the same used to control the displaying of images in an anima¬ 
tion. In that case, the delay would be more like 100 milliseconds or less. The method si eep() can be 
interrupted, throwing an InterruptedException which must be caught. The specification of run() in 
Thread doesn’t allow us to simply throw the exception up the line with a throws clause. 
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13,2.1 The interface Runnable 393 


Although the simplest way to create a thread is to extend the class Thread, it is not always the perferred way 
to create a thread. The often preferred alternative is to implement the interface java. 1 ang. Runnabl e as 
shown in the following variation of TwoTh reads and SimpleThread. 


//TwoThreads2.java - uses a class that implements Runnable 
// instead of one extending Thread 

class TwoThreads2{ 

public static void main(String[] args) { 

Thread tl = new Thread(new SimpleThread2(l, 1000)); 
Thread t2 = new Thread(new SimpleThread2(2, 1300)); 
tl.start(); 
t2.start(); 

} 

} 


The change in TwoThreads2 is that instances of Simp] eThread2 are passed to a Thread constructor. The 
constructor expects an object that has a method run() as specified by the interface java. 1 ang. Runnable. 

//SimpleThread2.java - implements Runnable instead of extending Thread 
class SimpleThread2 implements Runnable { 

SimpleThread2(int threadld, int threadDelay) { 
id = threadld; 

delay = threadDelay; // in milliseconds 

} 


public void run() { 

System.out.println("Thread" + id + " started."); 
System.out.flushQ; //needed to see the effect 
for (int i =0; i <10; i++) { 
try { 

Thread.currentThread().sleep(del ay); 


} 


} 

catch (InterruptedException 
System.out.printl n("sl eep 

} 

System.out.println("Thread" 

} 

System.out.println("Thread M + 


e) { 

interrupted: "+e); 

+ id + i = " +i); 
id + " finished."); 


private int id; 
private int delay; 

} 

There are only two changes to go from SimpleThread to SimpleThread2. The first change is that 
SimpleThread2 implements Runnable instead of extending Thread. This is the important change. One big 
advantage of this approach is that your thread class can now extend some existing class. 

The other change is in the call to sleepO. Because Simpl eThread2 does not extend Thread it does not 
inherit the sleepO method from Thread. Instead we use the static method Thread. currentTh read () to 
get a reference to the thread that is currently running and invoke si eep() on that thread. 
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1 3.3 COMMUNICATION BETWEEN TWO THREADS 


There are many ways for threads to communicate. The three most common forms are via shared objects, 
messages, or remote method invocation (RM). In this section we discuss communication via shared objects. 
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Later we show how to send messages over a network connection called a socket. We don’t discuss RMI in this 
book because of space limitations. 

In order for two threads to communicate via a shared object, both must have a reference to the same object. 
Once that has been established, any modifications made to the object by one thread are also observed by the 
other thread. One way to think of this is like a bulletin board on which anyone having access to it can write 
messages to be read by others with similar access. 

One way to create a shared object is to pass it to the threads when we create them. In the following program, 
we modify our two-threads example, passing a reference to a shared Counter object when constructing a 
Racer object. Each Racer object chcks the shared counter 1,000,000 times and then prints the value. We set 
the modulus of the counter at 10 million because we are interested in counting the total number of chcks. 

//TwoRacers.java - two threads sharing a counter 
class TwoRacers { 

public static void main(String[] args) { 

Counter counter = new Counter(0, 10000000); 

Thread tl = new Thread(new Racer(l, counter)); 

Thread t2 = new Thread(new Racer(2, counter)); 
tl.start(); 
t2.start(); 

} 

} 


//Racer.java - click the counter 1,000,000 times 
class Racer implements Runnable { 

RacerCint id, Counter counter) { 
this.id = id; 
this.counter = counter; 

} 

public void run() { 

System.out.printlnC’Thread" + id + " started.”); 
for (int i = 0; i < 1000000; i++) 
counter.click(); 

System.out.println(”Thread” + id + " finished counter is " + counter.get()); 

} 

private int id; 
private Counter counter; 

} 

In the preceding example one Counter object is being shared by two threads. Both call exactly the same 
cli ck() method and increment the same instance variable val ue inside a single Counter object. The 
threads more or less take turns. This is the same kind of sharing, called timesharing , that lets many different 
people simultaneously use one computer or lets one person do several things at once on a computer. For 
example, most systems allow a user to do somet hin g else while downloading large files with an Internet 
browser. 

The example also demonstrates the need for synchronization, which we discuss next. If you run the example 
using the Counter class described in Exercise 6 on page 189 in Chapter 6, the total number of chcks reported 
by the thread that finishes last varies from run to run, and will almost always be less than 2,000,000, the 
expected answer. When both threads try to click the counter at “exactly the same time,” some of the chcks 
are missed. We explain how they get missed in the next section. 
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1 3.4 SYNCHRONIZING TWO THREADS 


Two types of syndironization occur between two threads. The first, mutual exclusion synchronization , is used 
to protect certain critical sections of code from being executed simultaneously by two threads, such as the 
method click() in the class Counter. This protection is often necessary to maintain the correctness of the 
code. The second, signal-wait synchronization , is used when one thread needs to wait until another thread 
has completed some action before continuing. Java has mechanisms for both. 

All synchronization in Java is built around a relatively simple mechanism called a lock , and every Java object 
has an associated lock. Using appropriate syntax, we can specify that the lock for an object be locked when a 
method is called. Any further attempts to call a method for the locked object by other threads cause the 
thread to be suspended until the lock is unlocked. To make a method lockable, we simply specify that the 
method is synchronized by adding synch rorsi zed to the method header along with any access modifiers. 

Note that a lock only locks out other threads. The thread that locked a lock is said to be holding the lock. The 
thread holding a lock won’t be blocked if it calls another synchronized method for the same object. When a 
thread unlocks a lock, the thread is said to release the lock. The terms holding and releasing of a lock reflect 
the use of locks in operating systems to control access to resources that can’t be used by two programs at 
the same time, such as a printer. A program that is using a particular resource such as a file is said to be 
holding the resource. When the program has finished with the resource it releases the resource for other pro¬ 
grams to use. 


1 3.4,1 MUTUAL EXCLUSION USING synchronized 

How did clicks get missed in the program Two Racers? Recall that a statement such as 
value = (value + 1) % modulus; 

is compiled as a sequence of primitive bytecodes. First, some bytecodes will compute (val ue + 1) % mod- 
u 1 us, leaving the result on the Java virtual machine’s stack. Then the result on the top of the stack is stored 
in the variable val ue. We s umm arize this process with the following pseudocode. 

Pseudocode for Computing value 

load value 
load 1 
add 

load modulus 
mod 

store value 

Each Java thread has its own stack that it uses for executing bytecodes. When the Java virtual machine 
switches from running one thread to running another, it switches to a different stack. This switch is called a 
context switch. Think of it as each thread having its own calculator. Operations on one calculator don’t affect 
the operations on the other calculator until the result is stored In memory. Because the threads share the 
same memory, once a result has been stored any future loads, even in other threads, encounter the modified 
result. 

When two threads are executing simultaneously, except as discussed shortly, the Java virtual machine can 
decide to switch from one thread to the other at any time. Suppose that thread tl is somewhere after the 
1 oad val ue bytecode but before the store val ue bytecode when the Java virtual machine decides to let 
thread t2 execute for awhile. When thread tl finally resumes, it stores whatever is on the top of its stack in 
val ue. In the meantime, if thread t2 has clicked the counter several times, all those clicks will be lost. The 
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integer in the field value computed by thread t2 is overwritten by the older, incorrect integer from tl’s 
stack. This type of error is called a race condition— hence the name of the class Racer. The following illustra¬ 
tion shows a context switch while tl is attempting to click the counter. The bytecodes load value and store 
value are abbreviated lv and sv, respectively. 


tl_ 

t2 

value 



^ context swljch 

I_ 

sv ... Iv ... sv ... Iv ... sv 
1 2 3 


sv 


1 


The solution in this case is to turn the method cl i ck() into a critical section. We don’t want to allow both 
threads to be executing the bytecodes for cl i ck() at the same time on the same Counter object. All we need 
to do is declare that the method is synchronized by adding the keyword synch roni zed to the declaration, as 
in 

//in class Counter 
public synchronized void click() { 
value = (value + 1) % modulus; 

} 

So why not just make all methods synchronized? The reason is that synchronization of a method adds extra 
work for the computer. Each time a synchronized method is called, the computer must check to be sure that 
no other thread is already executing in the method. More importantly, in some cases two threads must be 
allowed to execute simultaneously to achieve a desired result. 


1 3.4.2 SIGNAL-WAIT SYNCHRONIZATION 

Suppose that you have two threads, one called the producer and the other called the consumer. The producer 
computes some value, that is, “produces it,” and then places it in a shared object. The consumer reads the 
produced value and does something with it, that is, “consumes it.” We want this activity to repeat until some 
terminating condition is reached, and we want the producer and consumer, whenever possible, to execute 
simultaneously. How do we make sure that the consumer doesn’t consume the value until it has been pro¬ 
duced? The answer is that the producer signals when there is a new value to consume and that the consumer 
waits until signaled by the producer. Furthermore, the producer has to wait until the consumer has read the 
preceding value before writing in a new one. Thus the producer has to wait for the consumer to signal that it 
has read the new value. This problem is called the producer-consumer problem, and it models many real- 
world computer applications. 

Signal-wait synchronization is accomplished with two methods inherited from Object: wai t() and 
noti fy (). Although not shown in the preceding example, when a thread is executing inside a synchronized 
method for some object, call it obj, any other thread that attempts to call any synchronized method for ob j 
is blocked. It doesn’t need to be the same method for blocking to occur. Note that synchronization actually 
takes place at the object, not the thread. As it executes, a thread of execution “moves” from object to object 
by calling methods in different objects. 

When wai t () is called from within a synchronized method, the thread is suspended and the lock for the 
object is released. That is, other threads are now allowed to make calls to synchronized methods for the 
object. 

When notifyO is called from within a synchronized method, one thread, if there is one, that is suspended 
as a result of a wai t () call while executing in the same object, resumes. This thread won’t actually begin exe¬ 
cution until the thread c allin g noti fy () has returned from its synchronized method and released the lock. 
The following diagram shows the states that a thread can be in as a result of synchronization. Note that a 
thread can be in one of three states: It can be waiting for the lock; it can be waiting for a noti fy () from 
another thread; or it can be r unning , in which case it is holding the lock. 
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Thus there can be two or more threads “inside” synchronized methods for the same object. However, all but 
one are either suspended, or just awakened, waiting for the executing thread to release the lock. The meth¬ 
ods wai t () and noti fy () combined with synchronized methods turn any object into a synchronization con¬ 
struct, which is known as a monitor. 

Our producer-consumer program looks very much like our previous examples at the top level. Let’s create 
the two threads and start them r unnin g. 

//ProducerConsumer.java - signal/wait synchronization 
class ProducerConsumer { 

public static void main(String[] args) { 

Buffer buffer = new SingleBufferQ ; 

Thread prod = new new Thread(new Producer(buffer)); 

Thread cons = new Thread(new Consumer(buffer)); 
prod.start(); 
cons.start(); 

} 

} 

Each thread is passed a reference to a shared buffer used to communicate the produced value from the pro¬ 
ducer to the consumer. The producer and the consumer are very s imil ar and repeatedly try to put/get a value 
in/from the buffer. 

//Producer.java - "produce" the integers 0-9 
class Producer implements Runnable { 

Producer(Buffer buf) { 
buffer = buf; 

} 

public void run() { 

System.out.println("Producer started."); 
for (int i =0; i <10; i ++) { 

// code to produce a value here 

System.out.println("Producer produced " + i); 

buffer.put(i); // let i be the produced value 

} 

System.out.println("Producer is finished."); 

} 

private Buffer buffer; 

} 
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//Consumer.java - consume first 10 integers from buffer 
class Consumer implements Runnable { 

Consumer(Buffer buf) { 
buffer = buf; 

} 

public void run() { 

System.out.printlnC'Consumer started."); 
for (int i =0; i <10; i++) { 
int value = buffer.get(); 

System.out.printlnC'Consumer received " + value); 

// code to "consume” the value here 

} 

System.out.printlnC’Consumer is finished."); 

} 

private Buffer buffer; 

} 

All synchronization is done in the Buffer object. If the buffer wasn’t synchronized, the producer and con¬ 
sumer would just execute as fast as they could The consumer might get the same value several times from 
the buffer, or the producer might try to put a new value in the buffer before the consumer read the old one. 
In anticipation of a variation on this problem we define our buffer implementation in terms of a simple inter¬ 
face. 

//Buffer.java 
interface Buffer { 

void put(int newValue); 
int get(); 

} 

//Buffer.java - a synchronized shared buffer 
class SingleBuffer implements Bufferf 
synchronized void put(int newValue) { 
while (!empty) 
try { 

//wait for previous value to be consumed 
wait(); 

} 

catch(InterruptedException e) { 

System.out.println("wait interrupted: " + e); 

} 

value = newValue; 
empty = false; 
notifyO ; 

} 

synchronized int get() { 
while (empty) 
try { 

wait(); // wait for buffer to fill 

} 

catch(InterruptedException e) { 

System.out.println("wait interrupted: "+e); 

} 

empty = true; 
notifyO ; 
return value; 

} 

private boolean empty = true; 
private int value; 

} 
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Dissection of the Class SingleBuffer 


% synchronized void put(int newValue) 

Both put () and get () are synchronized. Thus, if one thread is executing put (), the other thread will be 
blocked if it tries to execute put () or get () for the same object. The mutual exclusion implied by syn- 
chroni zed applies to all methods for a single object, not just simultaneous calls to the same method. 

# while (!empty) 
try { 

wait(); // wait previous value to be consumed 

} 

catch(InterruptedException e) { 

System .out. println( H wait interrupted: " + e); 

} 

value = newValue; 
empty = false; 

notify(); 

We use the boolean field empty to keep track of whether the buffer contains a produced item that hasn’t 
yet been consumed or whether the buffer is empty. The buffer is initially empty, with empty set to true. 
We repeatedly check whether the buffer is empty. If it is, the loop terminates and we proceed to put the 
new value in value, set empty to false, and call notifyC). The call to notify () wakes up the con¬ 
sumer if it is waiting inside get (). If the buffer isn’t empty, we call wai t() to suspend the producer. 
This thread remains blocked until some other thread—-the consumer in this case—calls noti fy () from 
within a synchronized method of the same Buffer object. The wai t() call, like the s 1 eep() call, can 
throw an exception that we need to catch. 

H while (empty) 

//omitted 
empty = true; 
notify(); 
return value; 

The body of get () is almost the same as put(). We loop until the buffer isn’t empty in thi s case, setting 
empty to true once the loop exits. The call to noti fy() awakens the producer if it is waiting inside the 
method put(). 



1 3.43 CONDITION VARIABLES VERSUS SEMAPHORES 

Many different synchronization techniques have been developed. The synchronization technique that Java 
implements is called monitor synchronization . Each object with synchronized methods is called a monitor, and 
only one thread is allowed “into” the monitor at a time; that is, the entrance to synchronized methods is 
“monitored.” 

To allow for more sophisticated sychronization, monitors were extended in various ways to allow controlled 
suspension and resumption of several threads inside a monitor. In some versions of monitors, a thread can 
wait for a condition variable to become true and other threads can signal that a condition variable has 
become true. These waits and signals correspond to Java’s wai t() and noti fy(). An important aspect of 
condition variables is that if no thread is waiting, a signal has no effect. Also, just because a condition was 
signaled as being true doesn’t mean that it will still be true when the signaled thread finally resumes. 
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This is the reason that we used the loop whi 1 e (! empty) .. . instead of i f (! empty) ... in our producer- 
consumer example. In this particular example, which one we use won’t make any difference. For example, if 
the consumer is awakened, empty is guaranteed to be false. When using this type of synchronization, you 
should always check the condition that must be satisfied in order to continue before you actually continue. 
In other circumstances—for example, if there were two consumers—one consumer might wake up and find 
that some other consumer had already consumed the value. In that case, the consumer should just go back 
to waiting. 

Another fundamental sychronization method is semaphore synchronization. At first glance, semaphores look 
much like monitors with acqui re() and rel ease(). Conceptually, a semaphore is an object with two meth¬ 
ods, acqui re() and rel ease (), and an internal counter. The method acqui re() decrements the internal 
counter and blocks if the counter is less than zero. The method rel easeQ increments the internal counter 
and, if the value is less than or equal to zero, awakens one of the threads blocked in acqui re(). 

There is an important difference between semaphores and the monitor style of synchronization in Java. The 
Java monitors don’t have an internal counter. In Java, if you call noti fy () and no thread is blocked, nothing 
happens. A subsequent wait() will always wait. With semaphores, if you call rel ease (), a thread that 
comes along later will read the effect of that release via the internal counter and possibly pass right through 
a call to acqui re() without blocking. 

Beginning with Java 5.0 the standard Java packages include java, uti 1. concurrent. This package includes 
a number of classes and interfaces that are useful for concurrent programming. In particular there is a Sema¬ 
phore class. We can use semaphores to implement the buffer for our producer-consumer problem as shown 
by the following example. The class SemaphoreBuf f er can be substituted for SingleBuffer in our original 
ProducerConsumer code. 

//SemaphoreBuffer.java - use a Semaphore for synchronization 
import java.uti1.concurrent.Semaphore; 

class SemaphoreBuffer implements Buffer { 
public void put(int newValue) { 
try { 

// take control of the empty buffer 
empty.acquire(); 

} 

catch (InterruptedException e) { 

// panic - no recovery 
throw new Error(e.toStringQ) ; 

} 

value = newValue; 

// release the now full buffer 

full . releaseO ; 

} 

public int get() { 
try { 

//take control of the full buffer in order to empyt it 
full.acquire(); 

} 

catch (InterruptedException e) { 

// panic - no recovery 
throw new Error(e.toStringQ) ; 

} 

int result = value; 

// release the empty buffer so it can be refilled 
empty, rel easeQ ; 
return result; 


} 
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// initially there is one empty buffer slot 
private Semaphore empty = new Semaphore(l); 

// initially there are no full buffer slots 
private Semaphore full = new Semaphored) ; 
private int value; 

} 


] 3.4,4 ArrayBl ocki ngQueue 

Now that we have shown how you can do low level synchronization using Java object locks or a semaphore, 
we would like to point out that java. uti 1. concurrent has many classes that robustly handle many of the 
synchronization problems you will encounter. As an example, the producer-consumer problem above can be 
easily handled using any implementation of java, uti 1. concurrent. Blocki ngQueue. 

The following example uses an array implementation of a Blocki ngQueue to provide a bounded buffer of 
produced items waiting for consumption. In our example above, our buffers only had room for a single pro¬ 
duced item. This meant that the producer could not get ahead of the consumer. In some situations this might 
be desirable but in others it might be pref err able to allow the producer to get ahead. The following imple¬ 
mentation of the Buffer interface can be used in our original ProducerConsumer code with the line: 

Buffer buffer = new BoundedBuffer(10); 

which will create a buffer capable of storing 10 items at once. 

//BoundedBuffer.java 

import java.util.concurrent.ArrayBlockingQueue; 

class BoundedBuffer implements Buffer { 

BoundedBuffer(int size) { 

queue = new ArrayBlockingQueue<Integer>(size); 

} 


public void put(int newValue) { 
try { 

queue.put(newValue); 

} 

catch(InterruptedException e) { 
throw new Error(e.toStringQ); 

} 

} 

public int get() { 
int result; 
try { 

result = queue.take(); 

} 

catch(InterruptedException e) {* 
throw new Error(e.toStringO); 

} 

return result; 

} 

private ArrayBlockingQueue<Integer> queue; 


} 
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Dissection of BoundedBuffer 


• //BoundedBuffer.java - a synchronized shared buffer 

import java.util.concurrent.ArrayBlockingQueue; 

class BoundedBuffer implements Buffer { 

We will use the standard class ArrayBlocki ngQueue to do most of the work. We could have had our pro¬ 
ducer and consumer use ArrayBlocki ngQueue directly but we chose to continue to reuse our existing 

code as much as possible by using Ar rayBl ocki ngQueue to create another implementation of the inter¬ 
face Buffer. 

• BoundedBuffer(int size) { 

queue = new ArrayBlockingQueue<Integer>(size); 

} 

The size is the number of elements that can be put into the queue (buffer) without blocking. Our buffer 
will store integers. We will use Java’s auto-boxing to let us put primitive i nt values into our Array- 
Blocki ngQueue<Integer> which is expecting Integer object values instead. 

• public void put(int newValue) { 

try { 

queue.put(newValue); 

} 

catch(InterruptedException e) { 
throw new ErrorCe. toStringO) ; 

} 

} 

The method put 0 handles all necessary synchronization and blocking. If the queue is full the thread 
calling put () will block until another thread removes one or more items. In some situations it might be 
appropriate to just propogate the InterruptedExcepti on up out of put C). We wanted this implemen¬ 
tation of Buffer to work with our existing ProducerConsumer so we catch the exception and tumit into 
an error. 

• public int get() { 

int result; 
try { 

result = queue.take(); 

} 

catch(InterruptedException e) { 
throw new ErrorCe. toStringO) ; 

} 

return result; 

} 

The method take() will block if there are no items in the queue, otherwise it will remove one item from 
the queue and return it. As with put(), we want this implementation to work with the existing Producer- 

Consumer program so we catch the exception and turn it into an error which does not require a throws 
clause. 

private ArrayBlockingQueue<Integer> queue; 

} 

The declaration of the queue completes BoundedBuffer. java. 
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1 3.5 PASSING MESSAGES TO ANOTHER COMPUTER 


All threads created as part of a single Java program run on the same computer and can share objects, as 
we’ve discussed. What about communicating with a Java program on another computer, connected with a 
network? In this situation several options are available. Two approaches supported in standard Java are mes¬ 
sage passing, using a network connection called a socket, or remote method invocation called RMI. As men¬ 
tioned earlier, here we discuss only message passing. 

A socket is a connection to another computer via a TCP/EP network, the dominant protocol for communicat¬ 
ing over the Internet. Associated with every socket in Java is an input stream and an output stream. Once 
connected, the programs on the two ends of the connection communicate by reading and writing over these 
streams. When one program writes to its output stream, the same bytes appear on the input stream of the 
other program. 

To create a socket that is connected to another computer, you need to know two things: the network name of 
the computer, or host name, and which port to connect to. Of the thousands of ports, most preallocated sys¬ 
tem ports he in the range 0-1000, so unless you’re connecting to an existing system server, you should 
choose a port number greater than 1000. For example, port 80 is the http port for connecting to web servers, 
and port 25 is the standard port for connecting to e-mail servers. On Unix systems you can find the assigned 
ports by examining the file /etc/services. You’re free to pick any number that isn’t reserved—it just needs to 
be agreed upon at both ends of the connection. Think of the port number as being somewhat like a telephone 
extension. 

The first step in creating a socket connection is having one of the programs begin listening for connections. 
This program is traditionally called the server. It is waiting for a request to do something. The server first 
begins hstening for connections on a specific port. When another computer, or another program on the same 
computer, tries to connect to the same port, a socket connection is established. The following program lis¬ 
tens for connections and then simply prints out the characters it receives from a socket; it also sends the 
same characters back over the socket. 

//MiniServer.java - server that echos what it receives 
import java.io.*; 
import java.net.*; 

class MiniServerf 

public static void main (String args[]) throws java.io.IOException { 
if (args.length != 1) { 

System.out.println("Usage: " + "java MiniServer portnumber"); 

System.exit(l); 

} 

int portnum = Integer.parselnt(args[0]); 

ServerSocket sock = null; 
try { 

sock = new ServerSocket(portnum); 

} 

catch (IOException e) { 

System.out.println("Could not listen on port: " + portnum + ", " + e); 

System.exit(l); 

} 

System.out.println("Now listening at port " + portnum); 
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Socket clientSocket = null; 
try { 

clientSocket = sock.acceptQ ; 

} 

catch (IOException e) { 

System.out.printlnC'Accept failed: " + portnum + ”, " + e) ; 

System.exit(l); 

} 

BufferedReader input = new BufferedReader( 

new XnputStreamReader(clientSocket.getlnputStreamO)); 

PrintWriter output = new PrintWriter(cli entSocket. getOutputStreamO) ; 
System.out.println("Connection established."); 

int i =0; 

String line = input.readLine(); 
while (1ine!=null) { 

System.out.println(line); 
i ++; 

output. printlnC'line ,f + i + ":" + line); 

output.flushO ; 

line = input.readLine(); 

} 

} 

} 




Dissection of the Class MiniServer 


• import java. io.*; 
import java.net.*; 

We need classes from both packages. The socket classes are in java.net, and the stream classes are in 
j ava. i o. 

% if (args.length !=!){. 

System.out.println("Usage: " + "java MiniServer portnumber"); 

System.exit(l); 

} 

int portnum = Integer.parselnt(args[0]); 

The program expects the port number to be specified on the command line. 

# ServerSocket sock = null; 
try { 

sock = new ServerSocket(portnum); 

} 

catch (IOException e) { 

System.out.println("Could not listen on port: " + portnum + ", + e) ; 

System.exit(l); 

} 

A ServerSocket is used to listen for incoming connections. It doesn’t create a connection. Rather, it 
simply creates the local connection to the port so that the server can listen for connections as shown 
below. 
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% Socket clientSocket = null; 

try { 

clientSocket = sock.acceptO; 

} 

catch (IOException e) { 

System.out.print!nC'Accept failed: " + portnum + ", u + e); 

System.exit(l); 

} 

The call to accept () for the ServerSocket object actually begins listening. The call won’t return until 
an incoming request to connect is received. The call returns the actual Socket object to be used to com¬ 
municate with the other program. 

# BufferedReader input = new BufferedReader( 

new InputStreamReader(clientSocket .getlnputStreamQ)); 

PrintWriter output = new PrintWriter(clientSocket.getOutputStreamO) ; 

System.out.println("Connection established."); 

Associated with each socket is an InputStream object and an OutputStream object. These are what the 
program actually uses to send and receive data over the socket. The same techniques used for reading 
and writing i lies in Chapter 10, Reading and Writing Files , can be used to read and write data over a 
socket. Here we chose to read and write text streams. As discussed in Section Section 10.3.1, Parsing Text 
Streams , on page 303, a BufferedReader object can be used to read lines of text. To construct a Buff™ 
eredReader object from the InputStream object returned by getlnputStreamQ, we must first turn 
the InputStream into an InputStreamReader. Similarly, we can construct a PrintWriter object from 
the OutputStream object returned by getOutputStreamC). We could have used the more primitive 
InputStream and OutputStream objects to read and write bytes, but using the classes shown allows us 
to easily transfer text strings over the socket. 

# int i = 0; 

String line = input.readline(); 

while (line != null) { 

System.out.println(line); 
i++; 

output .printlnC’line "+ i + "+ line); 

output.f 1 ush(); 

line = input. readLineO; 

} 

With the appropriate streams established, we can now loop: reading one line in from the socket, printing 
it to the screen, and then echoing the line back out over the same socket. The method readLi ne() 
returns nul 1 if there is nothing more to read from the input stream, at which point the loop exits and 
the program terminates. We added a line number on the echoed result to make clear that the data being 
read by our test client is in fact the line from the Mi ni Server server. The call to f 1 ush () is required to 
force the data to move over the socket to the other end without delay. 



A program that connects to an established server is called a client. The following class is a trivial client for 
our Mi ni Server. 

//MiniClient.java - simple client for MiniServer 
import java.io.*; 
import java.net.*; 

class MiniClient{ 

public static void main (String args[]) throws java.io.IOException { 
if (args.length != 2) { 

System.out.println("Usage: " + "java MiniClient hostname portnumber"); 

System.exit(0); 

} 
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int portnum - Integer.parselnt(args[1]); 

Socket sock = new Socket(args[0], portnum); 

BufferedReader input = new BufferedReaderC 

new InputStreamReader(sock.getlnputStreamC))); 
PrintWriter output = new PrintWriter(sock.getOutputStreamO) ; 
System.out.println("Connection established."); 


System.out.println("type some characters then return:"); 
BufferedReader consoleln = 

new BufferedReader(new InputStreamReader(System.in)); 
String line = consoleln.readLine(); 


while (line !- null) { 
output.println(line); 
output.flush(); 
line = input.readLine(); 

System.out.println("got back:" + line); 

System.out.println("type some characters then return:"); 
line = consoleln.readLine(); 

} 

} 

} 




Dissection of the Class MiniClient 

# Socket sock = new Socket(args[0], portnum); 

The name of the server is the first co mm and line argument. The server name and the port number are 
used to open the socket. The constructor won’t complete its task until the socket is established. The cli¬ 
ent end is simpler than the server end. Here we simply attempt to connect to a port. If there’s no server 
listening on the port, the constructor generates an IOExcepti on. 

# BufferedReader input = new BufferedReaderC 

new InputStreamReader(sock.getlnputStreamO)); 

PrintWriter output = new PrintWriter(sock.getOutputStreamO) ; 

System.out.println("Connection established."); 

These statements are essentially identical to those in Mi ni Server after the socket is established. At this 
point both ends of the socket look the same. 

# System.out.println("type some characters then return:"); 

BufferedReader consoleln = 

new BufferedReader(new InputStreamReader(System.in)); 

String line = consoleln.readLine(); 
while (line 1= null) { 
output.println(line); 
output.flush(); 
line = input.readLine(); 

System.out.printlnC'got back:" + line); 

System,out.printing”type some characters then return:"); 
line * consoleln.readLineC); 

} 

Here we prompt the user to type something at the console. Whatever is typed at the console of the client 
machine is printed on the console of the server machine. In addition, the Mi ni Server sends back what¬ 
ever it receives after prepending the word line followed by the line number. Here we print out the line 
that is bounced back. As in Mi ni Server, the program ends when Consol e . i n. readLi ne () returns 
null. On most Unix computers the use signals EOF at the console by typing Ctrl+D. On Windows 
machines the user signals EOF at the console by typing Ctrl+Z. 
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1 3.6 A MULTITHREADED SERVER 


In the client-server example in Section 13.5, Passing Messages to Another Computer , on page 403, we didn t 
actually create any explicit threads. Each program running on a different computer, or at least in a different 
Java virtual machine, had only one main thread. However, a typical server, such as a Web server, should be 
capable of handling many simultaneous connections. To build in this capability we create new threads in the 
Mi ni Server to handle each incoming connection. 

The multithreaded server is similar to the earlier, single-threaded version. There is now a loop around the 
call to acceptC). The Socket that is returned from acceptO is used to initialize a Worker. The Worker 
object handles all communication over the socket that it is passed. This new server works with the same cli¬ 
ent, Mini Client. 

The class Mul ti Server is the same as the class Mi ni Server to the point at which the message “Now listen¬ 
ing at port xxx” is printed. The revised code follows. 

//MultiServer.java - a multithreaded server 
import java.io.*; 
import java.net.*; 

class MultiServer { 

//omitted - same as Mini Server 

System.out.print!n("Now listening at port " + portnum); 

Socket clientSocket = null; 
while (true) { 
try { 

clientSocket = sock.acceptO ; 

} 

catch (IOException e) { 

System.out.printlnC'Accept failed: " + portnum + ", + e); 

System.exit(l); 

} 

Thread worker = new Thread(new Worker(clientSocket)); 
worker.start(); 

} 

} 

} 

The loop that actually reads from a socket is now in the class Worker. The run() method for the Worker con¬ 
tains the code that opens the input and output streams for the socket and then loops, reading from the input 
and echoing the result back out over the output. The method run() isn’t allowed to throw an IOExcepti on, 
so the entire body is wrapped in a try-catch statement that reports the error and exits. An IOException is 
thrown when the chent breaks the connection. We also added class and instance variables that are used to 
distinguish the different worker threads. 

//Worker.java - handle one connection 
import java.io.*; 
import java.net.*; 

class WorkerThread implements Runnable { 

WorkerThread(Socket socket) { 
clientSocket = socket; 
workerNumber++; 
number = workerNumber; 


} 
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public void run() { 
try { 

BufferedReader input = new BufferedReader( 

new InputStreamReader(clientSocket.getlnputStreamC))); 

PrintWriter output = new PrintWriter(clientSocket.getOutputStream()); 
System,out.println(’’Connect!on " + number + " established."); 

String line = input.readLine(); 
while (line != null) { 

System.out.println(line); 

output.println("worker " + number + ":"+line); 

output.flush(); 

line = input.readLine(); 

} 

} 

catch (IOException e) { 

System.out.println( e ); 

} 

System.out.println("worker " + number + " exiting"); 

} 

private Socket clientSocket; 
private static int workerNumber = 0; 
private int number; 

} 


1 3.6.1 REUSING WORKER. THREADS 

In the MultiServer program, each time a new connection is established a new Thread is created. Thread cre¬ 
ation is a relatively expensive operation. On a real server that was expected to handle hundreds or even thou¬ 
sands of connections, the extra overhead of creating the threads could become a problem. 

# ■ 

The standard Java package java, uti 1 . concurrent provides several classes that can be used to manage 
pools of worker threads that get reused instead of being created for a single connection and then destroyed. 

Here is a variation of the Multi Server that uses a java, uti 1 .concurrent. Executor to manage a pool of 
worker threads. 

//PoolServer.java - a multiserver that uses a worker pool 

import java.io.*; 

import java.net.*; 

import java.util.concurrent.*; 

class Pool Server { 

public static void main (String args[]) 

throws java.io.IOException,InterruptedException 

{ 

// omitted same as Mini Server 

System.out.println("Now listening at port " + portnum); 

Socket clientSocket = null; 

Executor pool = Executors.newCachedThreadPool(); 
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while (true) { 
try { 

clientSocket = sock.acceptO; 

} 

catch (IOException e) { 

System.out.print]n("Accept failed: " + portnum + ", " + e) ; 
System.exit(l); 

} 

pool.execute(new Worker(clientSocket)); 

} 

} 

} 
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Dissection of PoolServer 

class PoolServer { 

public static void main (String args[]) 

throws java.io.IOException,InterruptedException 

{ 

// omitted same as Mini Server 

System.out.println("Now listening at port " + portnum); 

Socket clientSocket = null; 

The first portion of all three servers, Mi ni Server, Mul ti Server, and Pool Server is the same. 

|| Executor pool = Executors.newCachedThreadPool(); 

The class Executors has a number of factory methods for creating particular kinds of Executor 
objects. An Executor can run jobs in separate threads. In this case the object returned by the call to 
newCachedThreadPool () is actually an instance of ThreadPool Executor, which is an implementation 
of the Executor interface. In our application we only care that it is an Exectuor. 

while (true) { 
try { 

clientSocket - sock.acceptO; 

} 

catch (IOException e) { 

System.out.println("Accept failed: " + portnum + ", 

System.exit(l); 

} 

pool.execute(new Worker(clientSocket)); 

} 



" + e); 


This is basically the same loop as the one used in Mul ti Server. The only difference is that here we use 
pool ,execute() to run the task. Because we used newCachedThreadPool () to create the Executor, 
the call to executeO will run the Worker in a thread taken from a pool of threads. The pool will be 
expanded as necessary and threads will be reused as the workers finish. Recall that a worker will finish 
when it’s run() method completes. 

Different types of thread pools could be created by simply changing the type of Executor that is created. 
For example we could have created a fixed size pool using Exectuors. newFi xedThread- 
Pool (POOL__SIZE). 
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13.7 MORE ABOUT THE METHODS sleepO, waitC), 

AND notify() 


We have presented some examples of how to use the three methods si eep(), waitC), and noti fy (). In this 
section we look closer at each of them. 


1 3.7,1 CALLING sleepO FROM ANYWHERE 

All execution of a Java program is associated with a Thread object. As we showed earlier in this chapter, a 
single Java program can have many threads. The Java virtual machine runs them so that they appear to be 
running at the same time. In fact, the Java virtual machine is using timesharing to run first one and then 
another, switching periodically from one to the next. 

Hence one Thread object is always associated with the method that is currently being executed. We demon¬ 
strated in the SimpleThread example in Section 13.2, Creating Threads, on page 391, that the method 
sleepO is defined in the class Thread and as such can be called directly from within the method run () of a 
class that extends Thread. In fact, as we showed in the first example in this chapter, AwtThread, we can call 
si eep() in any method; all we need to do is get a reference to the current Thread object. We do that by call¬ 
ing the static method Thread. currentThreadO at any time. This method returns a reference to the thread 
currently running. Thus we called Thread . currrentThreadO . si eep() in the method mai n () of Awt¬ 
Thread. 

Recall that sleepO can throw an InterruptedException and that in run() we were forced to catch the 
exception. The method run() was inherited from Thread. Because run() wasn’t defined in Thread to throw 
an Inter ruptedExcepti on— or any exception class that is a superclass of Inter ruptedExcepti on— we 
can’t throw such an exception in our definition of run(). In AwtThread, mai n() isn’t inherited, so we can 
define it to throw any exception. We could have used a try-catch statement to catch the exception had we 
so desired. 


13.7.2 CALLING waitQ AND notifyQ OUTSIDE A SYNCHRONIZED METHOD 

The methods wai t () and noti fy () are inherited from class Obj ect. Thus we might consider calling wai t O 
for any object. For example, what happens if we call wai t () for some arbitrary 7 St ri ng object? 

String s = "Wait for this?"; 
s.wait() ; 

This code is syntactically correct; that is, it will compile with no errors. However, the thread that executes 
this statement must hold the lock for the object s, or an II1 egalMoni torStateExcepti on will be thrown. 
Until now, the only way we have been able to obtain the lock is by calling a synchronized method. 

However, we can also obtain the lock for any object by using a synchronized statement. The general form for 
a synchronized statement is 

synchronized ( Expression ) Block 

The Expression must evaluate to a reference. If we let Expression refer to the object obj , the execution of Block 
is controlled by the lock for obj. That is, the thread is suspended if any other thread is executing inside a syn¬ 
chronized method for obj or is executing another synchronized statement for obj. As with synchronized 
methods, calls to wai t () and noti fy C) using obj can be placed inside Block. They can also be in methods 
that are called from inside Block. 

The following is an example of waiting with a synchronized statement. 
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String s = "Wait for this?"; 

■ p * 

synchronized(s) { 
s.wait(); 

} 

This code can be placed in any method. The thread that executes it blocks until some other thread executes a 
notifyO call on the same object. The ellipses indicate the use of statements to pass a reference to s to 
some other thread so that the current thread can eventually be awakened. 

Suppose that you were writing a program and wanted to share an object for a class written by someone else. 
Suppose also that it isn’t possible for you to modify the class to change the methods into synchronized 
methods as we did for the class Counter. This situation is perfect lor use of the synchronized statement. In 
the following program we modified the class Racer to work with Counter, as it was before we changed the 
method cl i ck() into a synchronized method. 


//RacerZ.java - assume clickQ is not synchronized 
class Racer2 extends Thread { 

Racer2(int id, Counter counter) { 
this.id = id; 
this.counter = counter; 


} 


} 

public void run() { 

System.out.println(”Thread" + id + 
for (int i = 0; i < 1000000; i++) { 
synchronized(counter) { // change 

counter.click(); 

} // change 


started."); 
from Racer 
from Racer 


} 

System, out. pri ntl.n("Thread" + id + 

" finished counter is " + counter.get()); 


} 

private int id; 
private Counter counter; 


1 3.7.3 THE METHOD notifyAIIO 

A call to the method noti fy () for an object wakes up one thread if any threads are waiting as a result of 
calls to wai t () for the object. If there is more than one thread, one thread is chosen arbitrarily. A call to the 
method noti fyAl 1 () for an object wakes up all the threads waiting for the object. These threads, although 
“awakened,” still need to wait to obtain the lock for the object before they proceed. Only one thread can hold 
the lock at any one time. The lock is passed from one thread to the next as the running thread leaves its syn¬ 
chronized method or block. Presumably each thread checks to determine whether it should proceed with its 
processing or go back to waiting. 

You should use the method noti f y () when you know that there is at most one thread waiting or when any 
of the waiting threads can do the job. For example, in the producer-consumer problem, the producer can use 
noti fy () because only the consumer can be waiting. 

You should use the method noti fyAl 1 () when you know that only a particular subset, including possibly 
none, of the waiting threads are the ones that need to be awakened. Consider a variation of the producer- 
consumer problem, with specialized consumers for different values. The producer would use noti fyAl 1 () 
to awaken all waiting consumers. Each consumer would check and determine whether the newly produced 
value was for it; if so, it would consume the value. If the value wasn’t for that consumer, it would just go back 
to waiting. An apparent alternative would be to use noti fy () and have the awakened consumer, if it didn’t 
want the value, call noti fy () to awaken the next consumer. The problem with this approach is that the spec¬ 
ification of noti fy () doesn’t guarantee the notification of all consumers. The choice of which waiting pro¬ 
cess to awaken is arbitrary. Two consumers could keep waking up each other without ever awakening a third 
consumer, which was the one that was needing the value. 


















4 7 2 Threads; Concurrent Programming 


Common Programming Error 

Multithreaded programs can exhibit two types of errors that never occur in sequential programs. The 
first type is a race condition. We showed earlier how two threads with references to a shared object can 
interfere with each other. Errors caused by race conditions are notoriously difficult to detect. The error 
may not appear, even with extensive testing, because the context switch never happens to occur in the 
right place to exhibit the error. Moreover, once the error has been observed, it may be difficult to repro¬ 
duce the condition, making locating the problem in the code difficult. For this reason, you must take 
extreme care when writing programs with multiple threads that share objects. 

second type of error unique to multithreaded programs is called deadlock. It occurs when each 
tiiread in a group of threads is holding one lock and waiting for another lock that is currently held by 
another thread in the group. The potential for deadlock is one of the reasons that you can’t simply add 
synch roni zed to all your methods in the hope of eliminating all race conditions. Suppose that you have 
a class with two methods—call them methodOneO and methodTwoQ. If methodOneQ calls meth- 
odTwo() for a different object of the same class, synchronizing the methods can lead to deadlock. If one 
thread is executing methodOneO for the first object and another thread is executing methodOneO for 
the second object, each thread will be holding the lock for one of the objects and waiting for the lock for 
the other object as shown in the following diagram. 


Thread one Thread two 


: wait for lock for objectOne 
enter methodOneO for objectOne 

context 

switch 

m 

& 

wait for lock for objectTwo 
enter methodOneO for objectTwo 

call objectTwo.methodTwoO 
wait for lock for objectTwo 

-- i 

‘ - - - _ ^ 

call objectOne.methodTwoO 
wait for lock for objectOne 


both 

waiting 


A complete discussion of avoiding deadlock is beyond the scope of this book. Briefly however, one tech¬ 
nique for avoiding deadlock is to use resource ordering. With resource ordering, each lockable object 
resource) is given a number. A thread is always required to obtain the locks for lower numbered 
resources before obtaining locks for higher numbered resources. This procedure isn’t provided by the 
language; it is something that must be done by careful programming. 

In this example tnere are two resources, objectOne and objectTwo. For resource ordering, their num¬ 
bers correspond to their names. Thread 1 locks the resources in the proper order: objectOne and then 
objectTwo. Flowever, thread 2 locks the resources in the wrong order, locking the higher numbered 
object, objectTwo, before the lower numbered object, objectOne. 
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The solution to this problem depends on what is actually being done by the two threads. One solution 
would be to have each of the two threads explicitly obtain the locks for both objectOne and objectTwo 
in the proper order before proceeding to call methodOneO for either object. We can do so by using a 
synchronized statement. Suppose that the actual call to methodOneO looked like the following in the 
code executed by both threads: 

objectA.methodOne(objectB); 

where, for thread 1, objectA is actually a reference to objectOne and objectB is actually a reference to 
objectTwo. Instead of relying on synchronized methods, we can obtain both locks as follows. 

synchronized(objectA) { 
synchronized(objectB) { 

objectA.methodOne(objectB); 

} 

} 

However, this solution would still get the locks in the wrong order for thread 2, because in thread 2 
objectA is a reference to objectTwo. To allow each thread to obtain the locks in a different order, we 
could add a resource number field to the objects. If we did that, the code might look like the following. 

Resource resOne, resTwo; 

if (objectA.getResNumber() < objectB.getResNumberO) { 
resOne = objectA; 
resTwo = objectB; 

} 

else { 

resOne = objectB; 
resTwo « objectA; 

} 

synchronized(resOne) { 
synchronized(resTwo) { 

objectA.methodOne(objectB); 

} 

} 

With this code, the earlier deadlock would be avoided because both threads would lock the locks in the 
same order. Thus it would be impossible for one thread to be holding one of the locks while waiting for 
the other lock. 

Obviously, avoiding deadlock can be rather complicated. The simplest solution is to design your pro¬ 
gram, whenever possible, to never lock more than one lock at a time. Deadlock can never occur if a 
thread holds only one lock at a time. You can read more about deadlock in any book about operating sys¬ 
tem principles. 
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13.8 FUTURES 


The standard Thread class allows one thread to wait for another thread to terminate via the method joi n(). 
A call to someThread. joi n() will block until the thread someThread terminates - that is until it’s run() 
method returns. 

A more flexible way of scheduling some computation to run asynchronously and then at some point in the 
future wait for that computation to return a result can be done using java.uti 1 . concurrent. FutureTask. 
The following program is intended as a template for a program with the following general behavior. 

% Several tasks need to be started up to run in parallel. 

# Each task performs some work and then returns a result. 

In our sample program each task reads an integer from a socket (as a string of digits), does some processing 
on that integer and returns the result. In a real application the task might read an arbitrary amount of data 
from the socket (or elsewhere) and perform and arbitrarly complex computation in order to compute its 
result. This program is different from Multi Server and Pool Server because in those previous examples 
the server didn’t collect any results from the asynchronous worker threads. 

//DataCollector.java - an example using FutureTask from java.uti1.concurrent 

import java.io.*; 

import java.net.*; 

import java.util.*; 

import java.util.concurrent.*; 

class DataCollector { 

static final int NUM_TASKS = 4; 
public static void main (String args[]) 

throws IOException, InterruptedException, ExecutionException 

{ 

if (args.length != 1) { 

System.out.println("Usage: " + "java DataCollector portnumber"); 

System.exit(l); 

} 

// set up the server socket listening for connections 
int portnum = Integer.parselnt(args[0]); 

ServerSocket sock = null; 
try { 

sock = new ServerSocket(portnum); 

} 

catch (IOException e) { 

System.out.println("Could not listen on port: " + portnum + ", " + e); 

System.exit(l); 

} 

System.out.println("Now listening at port " + portnum); 

Socket clientSocket = null; 

// create the pool of workers 

ExecutorService pool = Executors.newCachedThreadPool(); 

// used to hold the unconsumed futures 

Vector<FutureTask<Integer» tasks = new Vector<FutureTask<Integer»(); 
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while (true) { 

// start off some workers as connections come in 
for (int i =0; i < NUM_TASKS; i++) { 
try { 

clientSocket = sock.acceptQ ; 

} 

catch (IOException e) { 

System.out.println("Accept failed: " + portnum + ", + e); 

System.exit(l); 

} 

// worker asynchronously computes a result 

tasks.add(new FutureTask<Integer>(new IntWorker(clientSocket))); 
pool.execute(tasks.elementAt(i)); 

} 

System.out.println("begin collecting results - waiting if necessary"); 
for (int i - 0; i < NUM_TASKS; i++) { 

System.out.println("task " + i + " returned " + tasks.remove(0).get()); 

} 

} 

} 

} 




Dissection of DataCollector 


# //DataCollector.java - an example of FutureTask from java.util.concurrent 
import java.io.*; 

import java.net."; 
import java.util.*; 
import java.util.concurrent.*; 
class DataCollector { 

static final int NUM_TASKS = 4; 

This program uses a number of standard classes. The number of asynchronously executing tasks is con¬ 
trolled by this compile time constant NUNLTASKS. 

• public static void main (String args[]) 

throws IOException, InterruptedException, ExecutionException 

{ 

if (args.length != 1 ) { 

System.out.println("Usage: " + "java DataCollector portnumber"); 

System.exit(l); 

} 

// set up the server socket listening for connections 
int portnum - Integer.parselnt(args[0]); 

ServerSocket sock = null; 
try { 

sock 3 = new ServerSocket(portnum); 

} 

catch (IOException e) { 

System.out.println("Could not listen on port: "+ portnum + + e); 

System.exit(l); 

} 

System.out.println("Now listening at port " + portnum); 

Socket clientSocket = null; 

The be ginnin g of this program is essentially identical to Mi ni Server. It is creating a server socket on 
which to accept connections. 
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# // create the pool of workers 

Executor pool = Executors.newCachedThreadPool(); 

// used to hold the unconsumed futures 

Vector<FutureTaskdnteger» tasks = new Vector<FutureTask<Integer»() ; 

We create a worker pool just as we did in Pool Server. We also create aVector to store the futures. A 
future is a result that will be computed at some time in the future. 

# while (true) { 

As with the previous servers, this one goes into an infinite loop accepting remote connections and start¬ 
ing workers. The difference here as you will see in the next bit of code, is that this server starts 
NUM_TASKS asynchronous workers, then collects results from those NUM__TASKS workers, then starts 
NUNLTASKS more and so on 

# // start off some workers as connections come in 
for (int i - 0; i < NUM_TASKS; i++) { 

try { 

clientSocket = sock.aeceptQ ; 

} 

catch (IOException e) { 

System.out.pri ntl n("Accept failed: " + portnum + ", " + e); 

System.exit(l); 

} 

// worker asynchronously computes a result 

tasks.add(new FutureTask<Integer>(new IntWorker(clientSocket))); 
pool.execute(tasks.elementAt(i)); 

} 

This loop starts NUM_TASKS asynchronous worker threads. Each worker is remembered as a FutureTask 
in the Vector tasks. The FutureTask instances are parameterized with the type Integer which will be 
the type of result retrieved from the “future” when it completes. When the loop exits, NUM„TASKS 
instances of IntWorker will have been started. All, some, or none of them may have finished by the time 
the loop finishes. 

# System.out.print ln("begin collecting results - waiting if necessary 11 ); 
for (int i - 0; i < NUM__TASKS; i++) { 

System.out.println( n task " + i + " returned " + tasks.remove(0).get()); 

} 

This loop collects the results from the asynchronous tasks. In this example each result is an Integer 
which we simply print to the standard output. The expression tasks. remove (0) removes and returns 
the first FutureTask from the Vector. The method get() from class FutureTask returns the value 
from asynchronous task. If the task is not yet complete then the call to get () will block until the task 
has completed. 



The IntWorker objects needed by DataCol 1 ector are similar to the Worker objects from the earlier exam¬ 
ples. Operationally the difference is that the earlier Worker objects had no notion of a result or return value. 
The IntWorker objects on the other hand have to have a result. This is managed using the standard interface 
Cal 1 able instead of Runnabl e. Here is the code for IntWorker. 
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//IntWorker.java - produces one integer result 

import java.io.*; 

import java.net.*; 

import java.util.*; 

import java.util.concurrent.*; 

class IntWorker implements Cal 1able<Integer> { 

IntWorker(Socket socket) { 
clientSocket = socket; 
workerNumber++; 
number = workerNumber; 

} 

public Integer call() { 
int result; 
try { 

Scanner input = new Scanner(clientSocket.getlnputStreamO); 
PrintWriter out = new PrintWriter(clientSocket.getOutputStreamO) ; 
System.out.println("\tworker " + number + " started"); 

// simulate some long execution by sleeping 
try { 

Thread.currentThread().sleep(2000); 

} 

catch (InterruptedException e) {/* ignore it */ } 
result = input. nextlntO ; 

System.out.println("\tworker " + number + " received " + result); 
clientSocket.close(); 

} 

catch (IOException e) { 

System.out.println( e );. 
result = 0; 

} 

return result; 

} 

private Socket clientSocket; 
private static int workerNumber = 0; 
private int number; 

} 




Dissection of IntWorker 


• cl ass IntWorker implements Callable<Integer> { 

The interface java.uti 1 .concurrent .Callable is similar to Runnable but provides for a return value. 
In this case the return value will be of type Integer. 

# IntWorker(Socket socket) { 

clientSocket = socket; 
workerNumber++; 
number = workerNumber; 

} 

public Integer call() { 

The constructor for IntWorker is essentially the same as for Worker. The method call () required by 
the Cal 1 abl e interface is like run () but with a non-void return type. 
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• int result; 
try { 

Scanner input = new Scanner(clientSocket.getlnputStreamQ) ; 

PrintWriter out = new PrintWriter(clientSocket.getOutputStreamO) ; 

System.out.println("\tworker " + number + " started”); 

This is the same client socket setup used in Worker. The print statement is to help you see how the pro¬ 
gram is executing when you run it. 

• // simulate some long execution by sleeping 
try { 

Thread.currentThreadC).sleep(2000); 

} 

catch (InterruptedException e) {/* ignore it */ } 

In a real program this is where the work would get done. The input from the socket would be used to 
compute some result. We use si eep() so that you can actually see the tasks running concurrently via 
the various print statements. 

• result = input.nextlntQ ; 

System.out.println( n \tworker ” + number 4- " received " + result); 
clientSocket.closeQ ; 

} 

catch (IOException e) { 

System.out.println( e ); 
result = 0; 

} 

For this simple test the result is simply the value read from the socket. If there is a problem reading 
from the socket we print an error message and set the result to 0. 

• return result; 

This is the result that will be returned by tasks. remove (0) . get () from near the end of class DataCol - 
lector. 



In order to run DataCol 1 ector and have it do anything, we need a client program that will connect to the 
DataCol lector and send it integers over a socket. The following program IntCenerator will do that for us. 
It is very similar to Mi ni Cl i ent. 

//IntGenerator.java - simple client for DataCol1ector 
import java.io.*; 
import java.net.*; 
import java.util.*; 

class IntGeneratorf 

public static void main (String argsf]) 

throws java.io.IOException, InterruptedException 

{ 

if (args.length != 2) { 

System.out.println("Usage: " + "java IntGenerator hostname portnumber”); 

System.exit(0); 

} 

int portnum = Integer.parselnt(args[1]); 

Random rand = new RandomQ; 
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while(true) { 

// to simulate work for the client sleep 5 seconds 
Thread.currentThreadC).sleep(5000); 

// connect to the server 

Socket sock = new Socket(args[0], portnum); 

Scanner input ===== new Scanner(sock.getlnputStreamO) ; 

PrintWriter output ===== new PrintWriter(sock.getOutputStreamO) ; 

// send a random number 
int result = rand.nextlntO; 

System.out.println("\tSending: " + result); 
output.println(result); 
output.flushO; 

// make sure the integer is received by 
// waiting for other guy to close the socket 
try { 

String response = input.next(); 

} 

catch (Exception e) { /* ignore it */ } 
sock.closeO; 

} 

} 

} 

The actual output of running DataCol 1 ector and some IntGenerator clients will vary from execution to 
execution. Here is the output resulting from one sample run. For this run, four different IntGenerator cli¬ 
ents were started at essentially the same time all trying to connect to the DataCol lector. 

os-prompt>java DataCollector 4444 
Now listening at port 4444 

worker 1 started 

worker 2 started 

worker 3 started 

worker 1 received -1027045619 

begin collecting results- - waiting if necessary 

task 0 returned -1027045619 

worker 4 started 
worker 2 received -1989778283 
task 1 returned -1989778283 

worker 3 received -1844708987 
task 2 returned -1844708987 

worker 4 received -1417243180 
task 3 returned -1417243180 

worker 5 started 

worker 6 started 

worker 7 started 

worker 5 received -1769887349 

begin collecting results - waiting if necessary 



13.9 PROGRAMMING STYLE 


Although synchronized methods are easy to create, as illustrated earlier, using them correctly isn’t always so 
easy. One of the advantages of the data abstraction provided by the class construct is the ability to insulate 
the Implementation details of a class from its uses. However, use of synchronized methods can unnecessarily 
expose implementation details of a class to the users of the class. 
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As discussed earlier, a synchronized method must first obtain the lock for the object used to call the 
method. For example, if cri ti cal () is a synchronized method in the class SomeCl ass, and some Ob j is an 
instance of SomeCl ass, then 

someObj.critical(); 

must first obtain the lock for someObj before executing. However, there is no way to prevent a programmer 
from using someObj in a synchronized statement such as 

synchronized(someObj) { 

// make calls, possibly obtaining other locks 

} 

When the program contains statements such as this one, reasoning about the correctness of SomeCl ass with 
respect to whether or not it will deadlock becomes much more difficult. In any part of the program we can 
lock the lock needed by the call to cri ti cal (). 

An alternative that doesn’t expose this synchronization aspect of SomeCl ass is to use an internal private 
lock object and synchronized statements instead of sychronized methods. The following example shows how 
to do this. 

class SomeClass { 
void critical () { 

synchronized(lock) { 

// method body here 

} 

} 

private Lock lock = new Lock(); 

} 

The class Lock can be a trivial empty class or any existing class, such as Bool ean or Object. We never use 
the lock object except for its implicit built-in lock, which is part of every object in Java. 

In the preceding example, note that we need only to examine the code for the class SomeClass and the 
classes called by the methods in SomeClass, to determine whether the code might deadlock. Users of Some- 
Class can’t accidentally cause the method cri ti cal () to be locked out by inappropriate use of synchro¬ 
nized statements that synchronize on instances of SomeCl ass. 



Summary 


# A thread is a sequence of instructions executed by a program. In Java programs, many threads can be 
executing simultaneously. 

H Programs that use AWT are implicitly multithreaded. They contain a main thread specified by mai n(), 
and a second thread that responds to events and drives the GUI-based part of the program. 

# Threads are created in Java by extending and instantiating the class Thread. The top level, or main, 
instructions for the thread are specified in the method run(). To start the thread, call the method 
start (). You shouldn’t call the method run() directly. 

# The easiest way for two threads to communicate is for them to share an object. Any modifications made 
to the object by one of the threads is observed by the other. 

# When you use shared objects, you should synchronize the threads’ actions. Without synchronization, 
race conditions can cause errors. Race conditions can be hard to track down because the behavior of a 
program may not be consistent from one execution to the next. 
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# The keyword synch roni zed on a method prevents multiple threads from simultaneously accessing that 
method or other synchronized methods in the same object. 

# A thread executing inside a synchronized method can explicitly yield control to another thread by calling 
wai t (). The thread remains suspended until it resumes as the result of a call to noti fy () or noti fy- 

All (). 

fj A call to notifyC) for an object results in at most one thread, suspended by a call to waitQ for the 
same object, being resumed. The resumed thread isn’t actually allowed to continue until the thread call¬ 
ing noti fy () has released the lock. If several threads are waiting, an arbitrary thread is selected to be 
resumed. If no threads are waiting, this call has no effect. 

% The method notifyAll () is similar to notifyC), except that all threads suspended by calls to wait() 
for the same object resume. These threads still need to wait and take turns obtaining the lock for the 
synchronized object. 

# A thread that has resumed after a wai t () should verify that the condition that it was waiting for has 
actually been satisfied. In our example, the consumer needs to verify that the buffer is full before pro¬ 
ceeding. 

f| The style of synchronization used in Java involving synchronized methods (also known as critical sec¬ 
tions), along with methods wai t () and noti fy (), is called monitor synchronization. Although similar in 
appearance, semaphores behave somewhat differently. Specifically, a monitor wai t() always waits, at 
least briefly, but a semaphore acqui re() may continue without waiting, as a result of previous 
re 1 ease C) operations. 

# A socket can be used to connect two programs running on different computers. In Java, data are read 
and written over a socket by first obtaining an input stream and an output stream associated with the 
socket. These streams can then be used like any other stream, such as the stream to the console or to a 

file. 


# Creating a socket connection is asymmetrical, although once established, the connection is symmetrical. 
The server must first begin listening for connection requests, using the accept () method from class 
Server Socket. The client can then connect by creating a client socket implemented by the class Socket. 
The accept () call returns the server end of the client socket to the server. 

# By combining sockets and threads, you can create a multithreaded server to handle simultaneously many 
client connections with a single Java program. 



Review Questions 


1. What three capabilities are needed to support multiple threads? 

2. What is the implicit thread created inside AWT used for? 

3. What are the units of time for the method si eepO? 

4. What method do you call to run a thread? 

5. What method in a thread is similar to mai n () for the entire program? 

6. Failing to synchronize a shared object can result in a_condition. 

7. A lock is associated with what? A thread, an object, a method, or a variable? 

8. What is the difference between a Java monitor wai t () and a semaphore acqui reQ? 
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9. State why you should generally use 

while ( condition ) { 
wai t(); 

} 

instead of 

if ( condition ) { 
wait (); 

} 

10. Once a socket connection has been established, reading and writing data over the socket are just like 

WP - Tin - ■ 

11. What class defines the method sleepQ? wai t()? notifyO? 

12. Even after being awakened via noti fy(), a thread must wait for what before continuing? 



Exercises 


1. Add a menu or other GUI component to class AwtThread from Section 13.1, Implicit Threads from AWT , 
on page 390, that allows you to control the speed of counting. For example, the menu could have faster 
and slower selections that affect the time argument for the method si eep(). 

2. Write and test the class ThreeTbreads, which is similar to TwoThreads from Section 13.2, Creating 
Threads, on page 391, but with three threads. UsesleepO to make thread 1 run twice as fast as thread 2 
and thread 2 run twice as fast as thread 3. 

3. Modify the classes Racer and TwoTh read s2 to prompt the user for the number of times to click the 
counter. Using an unsynchronized counter, run the program with different values. Approximately how 
large does the input value need to be for the race condition to show up? Start with 10 and increase by a 
factor of 10 for each run. 

4. Modify the class Producer Con sumer to create two producers and two consumers. Does the program s till 
work? 

5. Modify the Buffer used in the class ProducerConsumer to use a ring buffer. A ring buffer can store as 
many as n items simultaneously. It behaves like a queue with producers inserting items at one end and 
consumers removing items from the other end. Use an array of size n. The buffer must maintain two 
indices for the array: one for the insertion point and the other for the removal point. If all array cells are 
empty, any consumers will block. If all cells are full, any producers will block. What problem might arise 
if you used a queue with unbounded capacity instead of a fixed size array? 

6. Write a program to implement a simple countdown timer. The program should prompt the user for the 
number of minutes and seconds. After you enter the seconds the timer starts automatically. Have it print 
out the time remaining every 5 seconds. You can cause your terminal to beep when the time has expired 
by printing out a string that includes \007, which is the escape sequence for the character to ring the bell 
on your ter min al. 

7. Create a version of the program in the preceding exercise that uses a graphical user interface. Include a 
Start button and a text field for entering the time setting. As the time ticks down, display the time 
remaining in the text field. You may notice that using sleepO to control the progress of the timer 
doesn’t always give accurate results. 
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If you used si eep(5000) to count off 5 seconds in the previous two exercises, you have failed to account 
for the actual time required to execute the parts of the program. You can use the method Date. get- 
Ti me() to get the current time in milli seconds since midnight January 7 1, 19/0, GMT. Use this method to 

create a more accurate timer. 

9. Another classic program for studying concurrent programming issues is called the dining philosophers 
problem. In this problem, five philosophers are seated around a table. In the center of the table is a bowl 
of spaghetti. In front of each philosopher is a plate and between each plate is a fork, as shown in the dia¬ 
gram. 



Each philosopher needs two forks to eat the spaghetti. Each philosopher repeatedly thinks then eats. In 
order to eat, the philosopher must pick up the fork on the right and the fork on the left. If either fork is 
busy, the philosopher simply waits for his or her colleague to put the fork down. The problem is to make 
sure that none of the philosophers starve. One solution is to have some start with their left fork and oth¬ 
ers start with their right fork. Implement the dining philosophers problem in Java. Each philosopher 
should be represented by a separate thread. The forks are to be objects with synchronized methods 
pickupO and putDownC). 

10. Modify the Mi ni Server and Mi niCl i ent programs to implement a simple Internet talk program. With 
this program, two users on different computers can each type at their consoles, and anything that they 
type will be echoed on the other person’s console. Be sure to use some prefix on each line to separate 
what the local user is typing from what the remote user is sending. You’ll need two threads: one to 
accept input from the console and send it out over the socket and the other to accept input from the 
socket and echo it to the console. 

11. Write a version of the talk program in the previous exercise that uses a graphical user interface. You can 
use two ITextArea objects: one for the local user to type in and another to echo the text from the 
remote user. 

12. The HTTP protocol used for Web servers is text based. In other words, control messages exchanged 
between client and server are text. Web browsers normally connect to port 80, but they can be directed to 
any port by appending :nnn to the URL, giving the port number nnn. Create a Web server that responds 
to all requests by sending a simple message in HTML. The server should listen for connections on port 80 
if your computer allows it; if not, use another port. When a connection is made, ignore the input stream 
and use the following code to send a message over the output stream, output. 

String message = 

"<HTML>\n" + n <centerxHl>Hel 1o from, Your Name Here</Hl>” + "</html>\n"; 
output.printlnCHTTP/1.0 200 0K\n” + 

"Date: <gone> \n" + 

"Server: 1.0 \n" + 

"Content-type: text/html \n" + 

"Content-length: " + 
message.length() + "\n\n" + 
message); 

output.flush(); 

Modify the message any way you like. For example you could include the count of how many times this 
“Web server” had been visited. The lines before the message comprise a header, which tells the client 
what’s co min g. When your server is running, point a Web browser at it by entering the url http:// 
yourComputersNamemnn , where nnn is the port number. You can leave off the nnn if you use port 80. To 
learn more, find some HTTP documentation and make your server actually interpret the incoming 
requests. 
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I 3. Write a class Semaphore that implements semaphore synchronization. The class should have two meth¬ 
ods: si gnal () and wai t (). Use your class Semaphore to synchronize access to the shared buffer in the 
producer-consumer problem. Compare this solution to the one based on monitor synchronization in 
Section 13.4.2, Signal-Wait Synchronization, on page 397. 

14. Use the method sleepO and a JApplet to create a simple animation. The applet should include an 
instance of a class—call it Animation— that extends JComponent, similar to Star in Section Section 8.5, 
Drawing with Swing, on page 238. Override the method pai ntComponent () in class Animation to draw 
a simple object—it could be as simple as a circle representing a ball. In a separate thread, created and 
started from the method i ni t () of the JAppl et, repeatedly modify the position of the object and call 
repaint () for the Animation object. You will need to pass a reference to the Animation object to the 
thread so that it can call the Animation's repaint () and also call some method in the Animation to 
adjust the image, for example changing the position of the ball. You may also want to override the 
update;,.; method of the Animation to just call paint(). The default update () method, inherited from 
1 Component, redraws the component in the background color and then calls pai nt(). This drawing of 
the background can cause a flicker. 
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In this appendix we take a closer look at how numeric primitive types are represented and how some opera¬ 
tions can be used to manipulate individual bits of memory. All data are represented using strings of Is and 
Os. We show how those strings of Is and Os are combined to represent more familiar numeric symbols. 



A.l INTEGER BINARY REPRESENTATION 


Integers are stored as binary numbers. Binary numbers are represented using only 2 digits, compared to the 
more familiar decimal numbers, which are represented using 10 digits. The number of distinct digits used in 
representing numbers determines the base. For example, decimal numbers are called base 10 numbers. Like¬ 
wise, binary numbers are base 2 numbers. In this appendix when we switch to a different number base, we 
use the notation (sequence of digit s)base, where base is the selected number base. Any numbers not written 
this way or otherwise indicated are decimal, or base 10, numbers. 


A.l.1 TWO’S COMPLEMENT BINARY ARITHMETIC 

Recall that decimal notation of numbers uses a positional notation to combine powers of 10 multiplied by 
one of the 10 digits 0 through 9. Therefore 123 equals 

1 X 10 2 + 2x 10 1 + 3 X 10° 

Because computers use only two digits, 0 and 1, integers are stored in binary notation, which combines pow¬ 
ers of 2 multiplied by one of the two digits 0 or 1. The binary notation for the decimal notation value (123) 10 
is ( 1111011 ) 2 , which is the same as 

6 5 4 3 2 1 0 

1x2 +1x2 +1x2 +1x2 +0x2 +1x2 +1x2 

or, after doing the multiplications, 64 + 32 + 16 + 8 - 1 - 0 - 1-2 + 1. 


The magnitude of the largest number respresentable in binary notation depends on the number of bits avail¬ 
able, that is, the number of binary digits that can be stored. The number of bits for the integral types is given 
in the table in Section 2.9.1, The Integer Types , on page 27. From that table, we see that type byte uses 8 bits 
and the range of values is from -128 to 127, inclusive. How are negative numbers represented, and why is 
127 the largest value when the binary notation number (11111111)2 fits in 8 bits and equals 255? The 
answers are related. 
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In some early computers, negative numbers were represented by allocating the left most bit as a sign bit—0 
for positive and 1 for negative-called signed magnitude. For the 8-bit integer type, that would mean 
(00000010)2 is and (10000010) 2 is -2. This notation isn’t very convenient for doing binary arithmetic. 

A more convenient form is called one's complement In it we negate a number by simply changing all Is to 0s 
and all 0s to Is. Therefore -2 would be represented as (11111101) 2 . Note that all negative numbers have a 
left-most bit of 1, as in the earlier form, but now we can perform normal binary arithmetic on any two num¬ 
bers, with the modification that any carry out of the left-most position must be added back into the right¬ 
most bit. For example 


11111101 

-2 


11111101 

-2 

+00000001 

+1 

+00000011 

+3 

11111110 

-1 

1 

1 _ 

00000001 

+1 

discard 


This representation does have a drawback: There are two forms of 0, +0 and -0, represented by all 0s and all 
Is, respectively. To avoid this problem, most computers today use what is known as two's complement binary 
representation for negative numbers. The positive numbers and 0 appear the same way in all three represen¬ 
tations. To obtain the n- bit two’s complement representation for a negative number, we add 2 n and treat the 
result as an u-bit unsigned number. For example, -2 as an 8-bit two’s complement binary number would be 
2 8 + (-2) which is 256 - 2 = 254 or (111 11110) 2 in binary. As with one’s complement, arithmetic is straight¬ 
forward; in fact we simply throw away any carry out of the last position. Using our same example we now get 


11111H0 

-2 

11111H0 

-2 

+00000001 

+1 

+00000011 

+3 

11111111 

-1 

rre000000i 

+1 


^ discard 


There is an even easier way to negate a number in two’s complement; that is, we can compute the one’s com¬ 
plement by toggling all the bits and then add 1. One peculiarity of two’s complement is that there is a shght 
asymmetry in the negative and postive numbers. Because zero uses one of the bit combinations with a left¬ 
most 0, the magnitude of the most negative number is 1 greater than the magnitude of the most positive 
number as shown in Section 2.9.1, The Integer Types, on page 27. 



A.2 FLOATING POINT REPRESENTATIONS 


The floating point numbers are represented using the IEEE 754-1985 standard. It is based on scientific nota¬ 
tion for numbers. In scientific notation, numbers are represented by a sign, some significant digits called the 
mantissa , and some power of 10, called the exponent. For example, in-2.56x1 O' 53 , the sign is negative, the 
mantissa is 2.56 and the exponent is -53. 


Floating point numbers are represented by allocating 1 bit for the sign, some bits for the mantissa (stored as 
an integer), and some bits for the exponent. Specifically, Java uses the IEEE standard, which allocates the bits 
as shown for the single precision floating point type f 1 oat. 


8-bit exponent E 


23-bit mantissa M 


bit sign 5 
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The bits are interpreted as follows. 

# If 5 is 0, then the number is positive; otherwise it is negative. 

# £is the exponent as a power of 2, not of 10. The exponent is interpreted as an excess-127 code integer. 
That is, the actual value of the exponent is E - 127, treating E as an unsigned binary integer. The result is 
that the exponent ranges from -127 to 128. 

# Mis the mantissa. Normal scientific notation places one decmial digit before the decimal point, for exam¬ 
ple, 1.27 x 10 15 . Similarly, M represents the mantissa with the binary' point to the right of the first signif¬ 
icant binary digit. Since the first significant digit is 1 unless the entire value is 0, the leading 1 isn’t 
stored. Therefore the actual value of the mantissa is (l.M) 2 . The only exception is when the exponent, £, 
is 0, in which case the actual value of the mantissa is (O.M) 2 . 

For example, suppose that the 32 bits of a floating point value are 

0 01001101 01101110000011010111011 

The sign is 0, so the number is positive. The exponent is (01001101) 2 - 127, which is 77 - 127, or -50. The 
mantissa is (1.01101110000011010111011) 2 , which is approximately 1.4298929. So the complete number is 
1.4298929 x 2' 50 , or approximately 1.27 x 10" 15 . 

Unlike some programming languages, floating point arithmetic operations in Java never generate an excep¬ 
tion. Instead, three special values can result: positive infinity , negative infinity , and Not a Number. The way 
that these three special values arise is shown in the following table. 


Name 

KvMvMvM-/*: * X I>X ’ I X : L X ' -V’X T'XvX*XyI X X-X . M>»X X\ XXX X X X X-VXXvXvrv.vl-I- 

Prints as 

Results from 

Example 

Positive infinity 

+Inf 

Overflow 

1.0e31f*1.0e8f 

Negative infillin' 

-Inf 

Overflow 

-1.0e31f*1.0e8f 

Positive 0 

+0 

Underflow 

1.0e-44f*0.0001 

Negative 0 

-0 

Underflow 

~1.0e-44f*0.0001f 

Not a Number 

NaN 

Undefined 

0 .0/0 .0 


Excess-127 is used for the exponent to facilitate comparison of two floating point values. If and y^ are the 
binary representations of two positive floating point values x and y, then x^ < y^ if and only if x < y. That is, 
the same hardware used to compare integers can be used to compare floating point values. That wouldn’t be 
true if one’s complement or two’s complement representations were used for the exponent. At the same 
time, addition and subtraction of exponents is more difficult. For most programs, this cost is outweighed by 
the easier comparison. 


Common Programming Error 

The computer, using floating point numbers, can’t exactly represent all numbers. Hence, when doing 
arithmetic with floating point numbers, the computer can’t produce precise results. This inability leads 
to both representational and roundoff errors. Roundoff errors result when, in performing a mathemati¬ 
cal computation (e.g., adding two numbers), the result is inexact. On a computer, 1.0 + e can end up 
being 1.0, with e, some very small number, getting lost. 
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As an exercise, ran the following program and explain the result. The simplest solution to roundoff 
errors is to modify the program to avoid combining numbers having widely differing magnitudes. 

//TestFloat.java - Compute with doubles 
class TestFloat { 

public static void main(String argv[]) { 
double sum = 0.0; 
double d = 1000000.0; 
double e - 1.0 / 100000; 
for (int i = 1; i <= 1000; i++) 
sum = sum + d + e; 

System.out.println(sum); 

} 

} 



A3 MANIPULATING BITS 


Java has seven operators that allow you to manipulate directly the bits used to represent the integral types. 
An i nt value can be viewed as an ordered collection of 32 boolean values, where 1 means true and 0 means 
false. These are not actual Java primitive type bool ean values; they can just be viewed in a similar way. For 
example, you can’t use them in the test expression for an i f statement. You can, however, perform boolean 
operations on them. 


A3.1 BITWISE OPERATORS 

There are four bitwise operators: & (and), | (or), a (exclusive-or), and - (complement). The first three opera¬ 
tors are binary operators. When these binary operators are apphed to two integer values, the specified bool¬ 
ean operation is apphed between each pair of bits in the two operands. For example 3 & 5 is equal to 1, as 
shown below: 

3 is represented as 00000000000000000000000000000011 
5 is represented as 00000000000000000000000000000101 
3 & 5 is then 00000000000000000000000000000001 

Only the right-most bit position contains 1 (true) in both operands, so all bits of the result are 0 (false) except 
the right-most. 

Similarly, the result of (3 | 5) is 7, which has the binary representation (111) 2 - The boolean operation 
exclusive-or results in true if and only if exactly one of the operands is true. Java doesn’t provide this opera¬ 
tor for the primitive boolean type. As a bitwise operator, the result bit is 1 if exactly one of the operand bits 
is 1. The value of the expression (3 a 5 ) is 6, which has the binary representation (110)2. The unary comple¬ 
ment operator ~ changes all Os to Is and Is to Os. 

These operations are summarized in the following table, where x and y are each one bit: 
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When these operators are applied to integral types, binary numeric promotion is first applied, as with the 
arithmetic operators (see Section 2.10.2, Type Conversion, on page 32). That is, both operands are converted 

to either type int or type long. 

These operators make possible the compact storage of many 1-bit data values. For example, pixels are the 
dots that are displayed to create a computer-generated image. For black and white images, each pixel is rep¬ 
resented by a single bit. If the bit is 1, the pixel is black, and if the bit is 0, the pixel is white. Using the bitwise 
operators we can store 8 pixel values in a variable of type byte. For example, a graphical representation of 
the letter A might be encoded by the 10 bytes 24, 60, 36, 102, 102, 126, 126, -61, -61, -61. We can illustrate 
this result by taking their binary representations and stacking them as follows. 


24 

00011000 

A 

rt 

A* 

rt 

60 

00111100 

*,*■* 

4% 

A 

4\ rt 

36 

00100100 

A 

rt 

J- 

4+ 

102 

01100110 

JU 
ri fv 

A 

4% 4% 

102 

01100110 

A Ji¬ 
ts 

A A 

126 

01111110 

rt *\ 

4% 4* 4% 

126 

01111110 

sL *1# 

4% r\ 

A* k'* 

4S. 4* fl 

-61 

11000011 


hpf* 

4\ fl 

-61 

11000011 

r\ 

A 

4\ 4\ 

-61 

11000011 

A **- 

4* 4\ 

J* A* 

4% 4% 


In addition to its being a compact representation of the graphical A, we can convert it to a reverse video ver¬ 
sion by applying the complement operator ~ to each of the 10 values. 

These operators have many other applications. The & operator is typically used to mask out certain bits. For 
example, the expression (x & mask) retains the bit values from x in each position where mask has a 1 and 
all other bits are set to 0, or masked out. Likewise, we can force certain bits to be “on” by using the I opera¬ 
tor. In the expression (x | f 1 agBi ts), the result retains all the Is in x and, in addition, turns on (i.e., sets to 

1) any bits that are 1 in fl agBi ts. 

Be careful of expressions like (x & y < 13), which is equivalent to ((x & y) < 13). This is not an expres¬ 
sion that is true whenever x and y are both less than 13 and false otherwise. See the Common Progr ammin g 
Error box at the end of this appendix. 


A.B.2 SHIFT OPERATORS 

In addition to turning bits on and off with the bitwise operators, integers, viewed as a sequence of bits, can 
be shifted right or left, s hifting bits to the left s bits is the same as multiplying by 2 s . This action is equivalent 
to always shifting in 0s to fill any vacated bits. The following sequence shows the initial value 3, represented 
using 8 binary digits, being shifted left, 1 bit at a time. 

00000011 equals 3 
00000110 equals 6 
00001100 equak 12 

shifting a positive value s bits to the right is equivalent to integer division by 2 s . Shifting negative values to 
the right can be done by either shifting in Os, called zero extension, or shifting in duplicates of the sign bit, 
called sign extension. The next sequence shows shifting to the right with sign extension of an 8-bit value 
two’s complement negative number. Java operates only on 32-bit and 64-bit values, but we use 8 for simplic¬ 
ity. For this example, simply note how the bits move to the right and that the left most bit retains it original 

value. 

11110100 equals -12 
11111010 equals -6 
11111101 equals -3 

The next sequence shows 0 extension of the same starting value. Note that, after the first shift, the value 
becomes positive. The second shift shows that shifting to the right is like division by 2 for positive values. 
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11110100 equals -12 
01111010 equals +250 
00111101 equals +125 

Recall that 0x01020408 is Java notation for an i nt literal in hexadecimal notation, which is useful when deal¬ 
ing with bits. Converting a hexadecimal number to binary is easy. Hexadecimal numbers can be converted to 
binary one digit at a time, as illustrated here. 

01020408 (hex) 

0000 0001 0000 0010 0000 0100 0000 1000 (binary) 

Hexadecimal notation is used in the examples for the shift operators, summarized in this table 


Operator 

.Operation 

Example 

. 

<< 

Shift left 

0x01020408 « 4 equals 0x10204080 

» 

Shift right, sign extend 

0x80402010 » 4 equals 0xf8040201 

»> 

Shift right, 0 fill 

0x80402010 »> 4 equals 0x08040201 


For example, shift operators can be used to assemble i nt and long values from bytes read from a network If 
a 32-bit integer was read from some low-level device or network connection as 4 bytes—call them byte0, 
bytel, byte2, and byte3— these four bytes might be assembled into an i nt with the expression 


int x = byte0 [ (bytel « 8) 


(byte2 « 16) 


(byte3 « 24) 


Common Programming Error 

The symbol & is both the bitwise operator, as just discussed, and a form of logical operator. If x and y 
are bool ean valued expressions, then (x & y) has the same value as (x && y). The only difference is 
that, in tlie former case, both expressions x and y will be evaluated no matter what. !n the latter case, 
which is the most commonly used, y will be evaluated only if x is true. The common form, &&, is called 
the conditional-and or short-circuit-and operator because the second operand isn’t always evaluated. 

Similarly, the common form of logical-or, ||, is actually the conditional-or operator. It evaluates its r igh t 

operand only if the left evaluates to false. The symbol | is the logical-or operator that always evaluates 
both of its operands. 

These double meanings for & and | can result in a very insidious mistake when we try to code state¬ 
ments such as “If x and y are both less than 13 do ....”. It is tempting to code this statement as 

if (x & y < 13) ... 

The correct Java expression is 
if (x < 13 & y < 13) ... 
or better still, use the conditional-and operator 
if (x < 13 && y < 13) ... 

The bad part about this error is that the first statement is syntactically correct - it will compile. The 

result of (x & y) is a number that can be compared against 13, although it won’t necessarily yield the 
desired result in this case. 
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For reference, here we include a complete operator precedence table and the standard Java math functions. 



B.l OPERATOR PRECEDENCE TABLE 


The precedence and associativity of all Java operators is given in the following table. The operators in the 
same row have the same precedence. The rows are ordered with the operators having the highest precedence 
at the top. 


Precedence 
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unary + 

unary - 

++expr 

--expr 
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cast ! 

Right to left 


new 
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Left to right 
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Keep this table handy when you begin using Java. Some useful generalizations can help you learn this table 
for the most commonly used operators. Unary operators have high precedence; then come multiplicative 
operators, followed by additive operators. In the middle of the precedence table are the relational operators, 
followed by the equality operators, followed by logical operators. Lowest on the list are assignment and oper¬ 
ator-assignment. 



B.2 THE STANDARD JAVA MATH FUNCTIONS 


Java provides a standard library of mathematics functions in the class j ava. 1 ang, Math. Because the pack¬ 
age j ava. 1 ang is part of every program by default, you can access the functions in the Math class by specify¬ 
ing the name of the class, Math, followed by a dot and the name of the method implementing the function. 
The functions in the class Math are listed in the following table. 


return type name(args) 

COMMENTS 

' •• •• • '• . . • 

double sin(double a) 

Return the sine of a, where a is in radians. 

The argument a is automatically converted, 
using a widening primitive conver sion if nec- 
essary. To store the result in anything other 
than a double requires an explicit cast such 
as 

float x = (float)sin(y); 

double cos(double a) 

Return the cosine of a. 

double tan(double a) 

Return the tangent of a. 

double asin(double a) 

Return the arcsine of a. The result is in radi¬ 
ans. 

double acos(double a) 

* 

Return the arccosine of a. The result is in 
radians. 

double atan(double a) 

Return the arctangent of a. The result is in 
radians. 

double atan2(double a, double b) 

Return the arctangent of b/a. This argument 
can be used to convert from rectangular 
coordinates to polar coordinates. The result 
is in radians. 

double exp(double a) 

Return e*, where e is the base of the natural 
logarithms. 

double log(double a) 

Return the natural logarithm of a. 

double sqrt(double a) 

Return the square root of a. 

double pow(double a, double b) 

Return a b . 
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return_type name(args) 

Comments 

ifm,:, ; - m 

double ceil(double a) 

Return the ceiling of a, that is, the smallest 
integer not less than a. The result, although 
mathematically an integer, isn’t a Java inte¬ 
gral type. 

double IEEEremainder(double a, double b) 

Return a-b n, where n is the integer value 
nearest to a/b. 

double floor(double a) 

Return the floor of a, that is, the largest inte¬ 
ger not greater than a—see comment for 
ceil. 

double rint(double a) 

Return the result of rounding to the nearest 
mathematical integer—see comment for 
ceil. 

int round(float a) 

Return the result of adding 0.5 then casting 
to an i nt. 

long round(double a) 

Return the result of adding 0.5 then casting 
to a long. 

double random() 

Return a uniform pseudorandom value 
greater than or equal to 0.0 but less than 

1.0—Section 4.6, Problem Solving: Random 
Numbers , on page 91 

T abs(T a) 

Return the absolute value of a; T can be any 
of int, long, float, or double. The return 
type will be the same as the argument type. 

T min(T a, T b) 

Return the smaller of a and b; T can be any 
of i nt, 1 ong, f 1 oat or doubl e. If both argu¬ 
ments aren’t of the same type, then a widen- 
ing primitive conversion will be applied to 
make them the same. 

T max(T a, T b) 

Return the larger of a and b— see comment 
above for min. 


For a complete specification of the behavior of these functions in the vicinity of extreme values, refer to the 
documentation for the class java. 1 ang . Math that came with your Java system. Surprisingly, for example, 
taking the abs() of the most negative i nt value returns that same negative value. This situation is an over¬ 
flow, and Java doesn’t signal integer overflow via an exception. The most negative i nt value has no corre¬ 
sponding positive i nt value. 
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Early versions of Java provided the GUI building package AWT. Later, the more comprehensive and flexible 
GUI package Swing was added. In this appendix we provide a summary of selected Swing components. The 
components covered are those that correspond to the GUI building components in the original AWT package. 
We selected this subset of Swing because it includes the components most commonly used. 


All the components described have additional features that we don’t discuss here. For a complete description 
of the methods available with any component, check the documentation that came with your Java develop¬ 
ment system. This information is also freely available from Sun Microsystems on the World Wide Web at 
java.sun.com. 

Although already covered, for ease of reference we include the classes JButton, ] Label, and JTextField in 
this section. Included in the descriptions are the names of the primary listeners that can be added to the var¬ 
ious components. We described these listeners in Section 9.7, Event Listeners and Adapters , on page 281. 



C.1 THE CLASS JButton 

This book contains several examples of the use of the class J Button. You construct a J Button by passing it a 
string that is used as the label for the button. To have some action performed when a button is pressed, you 
add an instance of Act ion Li stener to the J Button object, using addActionLi stenerQ. A second string, 
called the action command , is associated with a button. This command is passed to the acti onPerformedO 
method of any Acti onLi stener as part of the ActionEvent. By changing the action command, you can 
change the behavior of a button as the program executes. 



is displayed when the list isn’t pulled down. To have some action performed when a new item is chosen, you 
add an ItemLi stener to the JComboBox object. 


The following example shows what a JComboBox object looks like. 























































































































































































































436 Summary of Selected Swing Components 

//JComboBoxTest.java - a pull-down menu 
import javax.swing.*; 
import java.awt.*; 

class JComboBoxTest { 

public static void main(String[] args) { 

JFrame frame = new JFrame("JComboBoxTest"); 

Container display = frame.getContentPaneO; 

JComboBox list = new JComboBoxQ; 

list.addItem("Java"); 

list.addItem("C++"); 

list.addltemC”Pascal"); 

list.addItem("Ada"); 

display.add(list, BorderLayout.NORTH); 

frame. packQ ; 

frame.setVisible(true); 

} 

} 

1 he screen shot in part (a) is the normal view, showing Java selected. The screen shot in part (b) is what hap¬ 
pens when you press the mouse button while pointing at the JComboBox object and then drag down to select 

C++. 
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C.3 THE CLASS J List 


A J Li st component creates a list of options from which to choose. It is similar to a JComboBox, except that 
the list is always displayed instead of being hidden and then displayed only when selected. The currently 
selected item is highlighted, and more than one item can be selected simultaneously. To have some action 
performed when a new item is selected, you add anltemListener, as for JComboBox. The list items can be 
something other than simple strings. A JLi st can be made scrollable by placing it inside a JScrol 1 Pane 
(discussed in Section C.8, The Class JScrollPane, on page 440). 
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//DListTest.java - a simple list of items 
import javax.swing.*; 
import java.awt.*; 
class JListTest { 

public static void main(String[] args) { 

UFrame frame = new JFrame("3ListTest"); 

Container display = frame.getContentPaneC); 

String[] items = {"Java", "C++' 1 , "Pascal", "Ada", "Fortran"}; 

JList list = new JList(iterns); 

display.add(list); 

frame.pack(); 

frame.setVisible(true); 


} 


} 


Here is the output. We selected the first item, 3ava. 
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C.4 THE CLASS 3 Label 


A 3 Label is a very simple component. It displays static text or an image. No events are particular to the class 
3 Label. Because a J Label is also a Component, you could add a Component Li stener to it. You can change 
the text by calling setTextO, but the user can’t edit the text. 

The 3 Label constructor accepts an optional second parameter that can be used to set the ahgnment of the 
text. The possible values for the alignment parameter are 3Label . LEFT^ALIGNMENT, 3La- 
bel .RIGHT_ALIGNMENT, 3 Label .CENTER.ALIGNMENT, 3 Label .TOP.ALIGNMENT, and 3 La¬ 
bel . BOTTOM_ALIGNMENT. We used labels in Mi ni Cal c in Section 8.4, Using Several Components , on page 234 



C.5 THE CLASS DTextField 


A 3TextFiel d is like a 3Label, but the user can edit it. 3TextFiel d is the standard component for getting 
simple keyboard input such as numbers or strings from the user. It can be constructed with a default string 
to display, or it can be constructed to have space for a fixed number of characters. 

To have an action performed when the text is changed, you have two options. In our earlier examples we 
added an Acti onLi stener. The Acti onLi stener’s acti onPerformedO method is called when the user 
hits Return in the 3TextFi el d. For finer control over text changes, you can add a TextLi stener to the 
3TextFi el d object. The textVal ueChanged() method in TextLi stener is called whenever any change is 
made to the text, which includes adding or deleting a single character. As shown in the Mi ni Cal c example in 
Section 8.4, Using Several Components , on page 234, you can call the getTextO method of the 3TextField 
to identify the new contents of the field. 
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Whether a JTextField is editable by the user can be controlled with the method setEdi table(). The 
default is for the text to be editable. Calling setEdi tabl e() with fal se changes it to be not editable. 



C.6 THE CLASS jTextArea 


A JTextArea is like a JTextFiel d, except that it can display mutliple lines. When you place the JTextArea 
in a J Scrol 1 Pane, the text area can be scrolled. In a scrollable container, you can specify the number of lines 
to display and the number of characters per line when constructing the JTextArea. In addition to replacing 
the entire text string associated with a JTextArea, you can replace portions of the text. You can also respond 
to changes in the text by using a TextLi stener, as with JTextField. 

Using a JTextArea, adding simple text editing capability to any application is trivial. The JTextArea is a 
simple editor that supports insertion and deletion of text. In the following example you can edit the text in 
the window with the usual editing operations. The mouse and arrow keys can be used to move the insertion 
point or highlight a section to replace or delete with the Delete or Backspace key. 

This example creates a small text area to display four lines of at least 20 characters each. Any text that goes 
beyond this can be viewed by using the scroll bars. 

//TextAreaTest.java 
import javax.swing.*; 
import java.awt.*; 

class JTextAreaTest { 

public static void main(String[] args) { 

JFrame frame = new JFrameC’TextAreaTest"); 

Container display = frame.getContentPaneQ; 

JTextArea area = new JTextArea(4, 20); 

JScrollPane pane = new JScrol1Pane(area); 

area.append("This is a scrollable text area.\n"); 

area.append("It was constructed to display 4 lines"); 

area.append(" of 20 characters.\n"); 

area.append("The scrollbars can be used to view”); 

area.append(" text that doesn’t "); 

area.append("fit into the window.\n"); 

area.append("This is the fourth line.\n"); 

area.append("This is the fifth line.\n”); 

display.add(pane); 

frame.pack(); 

frame.setVisible(true); 

} 

} 

The following are four views of the output. The screen shot in part (a) shows the one that comes up first. Part 
(b) shows the window after the user has scrolled to the right. Part (c) shows how the mouse can be used to 
drag and select text. If Delete were hit at the point shown in part (c), the highlighted text would be deleted, 
resulting in the text shown in part (d). 
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C.7 THE CLASS DPanel 
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A J Panel has no appearance of its own. A j Panel is a Contai ner used to group several components. For 
example, a JFrame’s content pane, using a BorderLayout manager, can display only five components. How¬ 
ever, because any one of those five components could be a J Panel, you can actually display any number of 
components. You can of course put 3 Panels inside J Panels. 

The following example places a 3 Panel on the north and south borders of the main content pane and then 
places two labels in each of the 3 Panel objects. To fill out the display, additional labels are placed in the 
remaining BorderLayout positions. 

//3PanelTest.java - a simple container 
import javax.swing.*; 
import java.awt.*; 

class DPanelTest { 

public static void main(String[] args) { 

3Frame frame = new 3Frame("3PanelTest") ; 

Container display = frame.getContentPaneO ; 

3Panel top = new 3Panel(new BorderLayout()); 

3Panel bottom = new 3Panel(new BorderLayoutQ) ; 
top.add(new 3Label("one west"),BorderLayout.WEST); 
top.add(new 3Label("one east"),BorderLayout.EAST); 
bottom.add(new 3Label("two north"), BorderLayout.NORTH); 
bottom.add(new 3Label("two south"), BorderLayout.SOUTH); 
display.add(top, BorderLayout.NORTH); 
display.add(bottom, BorderLayout.SOUTH); 

display.add(new 3Label(" display center "), BorderLayout.CENTER); 

display.add(new 3Label("display west"), BorderLayout.WEST); 

display.add(new JLabel("display east"), BorderLayout.EAST); 

frame.pack(); 

frame.setVisible(true); 

} 


} 
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In the output the labels “two north” and “two south” are flush left because the default alignment for labels is 
left-aligned. 
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C.8 THE CLASS UScrollPane 


A j Sc roll Pane is like a J Panel that can be scrolled. A JScrollPane can contain only a single component, 
but because that Component can be a J Panel, the JScrol 1 Pane can effectively scroll any collection of com¬ 
ponents. 

We showed a simple example of a JScrol 1 Pane in the preceding JTextArea example. In the following exam¬ 
ple we included several of the components described earlier in this appendix. 

//JScrol 1 PaneTest.java 
import javax.swi ng .*; 
import java.awt.*; 

class JScrol1PaneTest { 

public static void main(String[] args) { 

JFrame frame = new JFrame("JScrollPaneTest"); 

Container display = frame.getContentPaneO ; 

JPanel panel = new JPanel(new BorderLayoutO); 

JScrollPane pane - new JScrol1Pane(panel); 
panel.add(new JButton("North"), BorderLayout.NORTH); 
panel.add(new JTextFiel d(" South"), BorderLayout.SOUTH); 
panel.add(new JLabel("Center"), BorderLayout.CENTER); 

String[] listltems = {"Westl", "West2", "West3"}; 

JList list = new J List(listltems); 
panel.add(list, BorderLayout.WEST); 

JComboBox choice = new JComboBox(); 

choice.addItem("Eastl"); 

choice.addItem("East2"); 

choice.addItem("East3"); 

panel.add(choice, BorderLayout.EAST); 

display.add(pane); 

frame.pack(); 

frame.setVisible(true); 

} 

} 

In part (a) the screen shot shows the display when the program starts. By default the JFrame makes itself 
large enough to show the entire JScrol 1 Pane. We used the desktop resize facility to reduce the size of the 
window, as shown in part (b). Note that scrollbars have been added automatically. 
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INDEX 



Symbols 

- unary 7 minus 43 

- unary 7 minus 38 
! not 50 

!= not equal 49 

$ dollar sign 18 
% modulus 31 
%= modulus assignment 3 5 
& and (bitwise) 428 
&& and 50 

&= and assignment 3 5 
() parentheses 84, 96, 218 

* asterisk (import) 228 

* multiply 30 

*= multiply assignment 3 5 
+ binary plus 3 8 
+ unary' plus 3 8 
++increment 36 
+= plus assignment 3 5 
/* */ comment 17 
/** */ comment (javadoc) 
111 

// single line comment 17 
/= divide assignment 3 5 
; semicolon 48, 56 
< less than 49 
« shift left 430 
«= shift left assignment 3 5 
<= less than or equal 49 

- assignment 21, 34 
-= minus assignment 3 5 
== equal 49 

> greater than 49 
>= greater than 49 
» shift right sign extend 

430 

»= shift right assignment 

35 

»> shift right zero fill 430 
\n newline 25 
a exclusive or (bitwise) 428 
A = or assignment (exclusive) 

35 

_ underscore 18 

{} braces 48, 85 
| or (bitwise) 428 
|= or assignment (inclusive) 

35 
II or 50 

- complement (bitwise) 428 

Numerics 

0 zero 153 


A 

abstract 214 
class 206 

datatype 167, 184 

method 206 
abstract data type xi 

abstraction 159-188 
access 203 
class 167 
modifier 83 

narrowing 200 

package 168, 199- 
200, 381 

private 167, 199, 203, 
382 

private field 174 
protected 202 

public 83, 167, 199, 
203,214,252,382 

action command 237, 435 
ActionEvent class 230, 

237 

ActionEventListener class 
230 

Actionlistener class 286 
adapter class 286 
Adjustmentlistener class 
286 

adt xi, 167, 184 

interface 168 

alert 2 9 
algorithms 1, 4 
Change-Making 3 
Cooking a Roast 2 
Two-Stack Polish Notation 

370 

Al-Khwarizmi, A. 4 
ambiguous call 110 

and && 50 
and (bitwise) & 428 
and assignment &= 3 5 
applet 7, 14, 227, 248, 
250-253 

init() 250 
tag 249 

appletviewer 251 
argument 
array 125 
command line 149 
method 96 

ArithmeticException 30 
array 121-153 

assignment 127 
declaration 122-123 
element 122 


index 122 

initialization 122, 139 
length 122, 124 

object 181 
one-dimensional 121, 

127-128 

ordered 132 
passing to method I 2 3 
String 149 

style 152 
subscript 122 
two-dimensional 138- 

139 
asch 300 
assertion 335, 369 
assignment 21, 34 
array 127 
expression 47 
multiple 34 

operators 35 

associativity 7 19, 37-38 

asterisk (import) * 228 

AWT 227, 390 

B 

bench testing 4 
Benefits of Using a Subclass 

196 

big-oh notation 134 
binary 425 
file 15, 299 

numeric promotion 3 0 
representation 425 
search 133 
binary minus - 3 8 
binary plus +38 
bit 27 

manipulation 428 
Operations Table 428 
representation 425- 

430 

Shift Operations Table 

430 

bitwise operator 428 

block 48, 51, 82 
comment 17 
inner 48 
nested 48 
outer 48 

body of method 82-83 
boolean 18, 49, 51 
BorderLayout class 241, 

259, 293 

braces {} 48, 85 
branch coverage 105 
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browser 7 
buffer 136 

Button class 19, 228 
byte 19, 27 

C 

Caesar cipher 309 
call 24, 171 

instance method 171- 

172 

method 82 
call-by-reference 177 
call-by-value 96 
CASE 185 
cast 27, 33, 218 

reference type 218 
superclass 219 

catch 324-325, 331 
char 18, 27 

character 

conversion 26 
Character Constants Table 
28 

Characteristics of Algorit hm 

4 

cipher 309 
class xi, 14 

abstract 206 
access 167 
adapter 286 
constant 180 
encapsulation 484 
extends 194, 238 

hierarchy 206 
import 201, 382 
interface 214 

library 200, 381 

listener adapter 286 

method 83 
private 167 
public 167 

qualified name 201, 382 

root 206 
static 166 

super 194 
type 19 

variable 169, 178 

classes 

See classes - Java below for 
classes in the Java 
standard libraries 
AbstractCounter 206 
AmbiguousOverload 110 
AppletSum 78 
ArraySum 123, 125 

ArrayTest 128 


Average 62 
AwtThread 390 
Binary Input 328, 333 
BinaryOutput 330 
BinarySearch 133 
BinlOTest 312 
BorderLayoutTest 260 
BreakContinue 68 

Buffer 398 
ButtonApplet 191 
CardTest _[84 
Change 172 
ClickCounter 390 
CoinToss 94, 1 I I 
CommandLine 150 
Consumer 398 
CountByTwo 206 
Counter 165, 168-169, 

178,180,187,206, 
335, 343 

Count erTest 165, 170 
CountWord 136 
DoMath 236 
DrawChairs 118 
DrawingCanvas 243- 

244,246 

Driver 203 
Echo 233, 315 
Empty 213 
EqualsTests 205 
FailedSwap 97 

FindRoot 109 
FirstApplet 44 
FlowLayoutTest 241 
Fox 210, 214 
GameOflife 143 
GameTest 282 
Generic Array 219 
GenericStackTest 369 
GoodBye 231 
Grass 212 
HelloButton 228 
HelloFile 301 
HelloGoodBye 230 
HelloWorld 13, 21 
Increment 36 
IntDListElement 367 
IntList 382 
IntListElement 357 
IntListlterator 374 
IntListSort 378 

IntStack 359, 381 
IteratorExample 375 
JComboBoxTest 436 
JListTest 437 
JPanelTest 439 


JScrollPaneTest 440 
JTextAreaTest 438 
ListElement 367 
Living 210 
MakeChange 5,31 
Message 82-83 
Min 85 

Min2Bad 87 
MiniCalc 234 

MiniCalcApplet 251 
MiniServer 403 
MisuseDatalnputStream 

313 

MocIifyParameters 177 
MultiServer 407 
Nesting 260 
NoBreakContinue 69 
PaintListener 244, 248. 
277 

PassingReferences 176 
PenAdjuster 277 
Person 202 

Plot 264 
PlotTest 265 
Pohsh 371 
Primes 135 
PrintMin 74 
Producer 397 
ProducerConsumer 397 
Queue 372 
QueueTest 373 
Rabbit 212 
Racer 394, 4 1 I 
RandomPrint 91 
Recur 106 

RunSums 89 
Scope 178 
SeiectionSort 130 
SimpleFindRoot 108 
SimplePaint 244 
SimpIePaintApplet 253 
SimplePaintCombined 

253 

SimplePaintMenu 276 
SimpIeThread 391 
SinFunction 265 
SomeCIass 420 
Sortlnput 53 
SquareRoots 66-67, 87 
Stack 368 

Star 239-240, 262 

StarTest 238 
StarTestQuit 242 
Status 324 
String Array 149 
StringVsId 22 
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StrokeSampler 273 
StudentEmployee 216 
StudentTest 196 
Subclass 198 
Superclass 198 
TestCopy 126 
TestFloat 428 
Testlnherit 199 

Textlnput 232 

Timer 207 

TwentyOnePickup 100 
TwoD 139 

TwoThreads 391 

UnamblguousOverload 

111 

Valentine 60 
WorkerThread 407 

World 209 

classes - Java 

See classes above for user- 
defined classes 
ActionEvent 230, 237 
ActionEventListener 230 
Actionlistener 286 
Adjustmentlistener 286 
BorderLayout 241, 259, 

293 

Button 19, 228 

ComponentListener 286 
ContainerListener 286 
DatalnputStream 311, 

313 

DataOutputStream 311, 

313 

Dimension 241 
Exception 336 

File 313 
FlowLayout 241 
FocusListener 286 
Graphics 237, 268, 

270, 293 

GridLayout 234, 293 

ItemListener 286 
JApplet 252 

jButton 230, 237, 435 

JComboBox 435 
JComponent 238, 261 
JFrame 243 
JLabel 235, 437 
Jlist 436 

JMenuBar 278, 293 
JMenultem 279, 293 
JPanel 261, 439 
JScrollPanel 440 
JTextArea 438 


JTextField 232, 437 
KeyListener 286 

Math 24, 432 
MouseListener 285-286 

MouseMotionListener 

245, 286 

Object 204 

Point 19 
PrintWriter 300 
Random 310 

ServerSocket 404 

String 18, 149, 366 
Thread 392, 410 
CLASSPATH 202, 383 
clear text 309 

client-server computing 8 
code reuse 383 
collaborator 185 

command line argument 

149 

comment 17 
block 17 

javadoc /** */ 111 
multiline /* */ 17 
single line // 17 

compile 14, 42 
complement (bitwise) - 428 
component 227, 234 
layout manager 234 
resize 261 

ComponentListener class 
286 

computation 4 
computer program 4 
concurrent programming 

389-421 

condition variable 399 

conditional-and 430 
conditional-or 430 
const 18 

constant 18, 28, 180 
final 180 
constructor 168 

default 168, 195 

no arg 168 
overloading 168 

superO 195 
consumer 396 
container 121, 229 
generic 219 

nested 260 

ContainerListener class 286 
context switch 395 
control flow 47-72 
control string 26 


conversion 27, 33 
binary numeric 3 0 
character 26 

narrowing 32-33 

specification 26 
widening 32, 110 

Conway, J. 140 
CRC notecard 185 
critical section 395 

D 

dangling else 5 9 

data 

abstraction 159-188 

hiding 167, 185 
member 165 
plot 263 

data structure 
array 121 

doubly linked list 366 

dynamic 357-384 

first-in-first-out 372 
generic stack 367 
iterator 373, 376 
last-in-first-out 372 

link 358 

list operations 365 
pointer 357 
queue 372 
recursive 357 
self-referential 357 
singly linked list 361 

stack 359 

datatype 18-20 

abstract 167, 184 

constant 18 
literal 1 8 

DatalnputStream class 311, 

313 

DataOutputStream class 

311, 313 

deadlock 412 
debugging 4 
declaration 19 
array 123_ 
variable 47 

Decomposing the Running 
Sum Program 88 
-decrement 36 
decrement - 3 6 
default constructor 195 
deferred method 206 
delegation model 229 
delete 380 
deprecate 314 
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design 184, 217, 222 

structured 81 
top-down 81, 88 
Dimension class 241 
dissections 
AppletSum 79 
ArraySum 123 
ArrayTest 129 
Average 63 
Binarylnput 329, 334 
Buffer 399, 409 
ButtonApplet 192 
Change 173 
CoinToss 95 
Counter 166 
CountWord 137 
Deck 183 
DrawChairs 119 
DrawingCanvas 247 
ExceptionExample 327 
Fox 211 
GoodBye 231 
HelloButton 228, 230 
HelloFile 301 
HelloWorld 14, 21 
IntList 363 
MakeChange 5, 31 
Message 83 
Min 85 

MiniCalcApplet 249, 
252 

MiniClient 406 
PaintListener 245, 248, 
280 

PenAdjuster 281 
Plot 267 

printRandomNumbersQ 

92 

readAndPrintData() 90 
SelectionSort 131 
setBoundsO 263 
SimplePaintMenu 278 
SimpleThread 392 
Sortlnput 54 
SquareRoots 66, 88 

Star 240 

StrokeSampler 274 
Student 195 
Twenty OnePickup 102 
divide assignment /= 3 5 
documentation 111 
dollar sign $ 18 

double 18-19, 28 

doubly linked list 366 
draw 

stroke 272 


dynamic data structure 

357-384 

dynamic method dispatch 

175,197 

dynamic typing 197 

E 

element of array 122 
else statement 5 5 
dangling 59 
empty statement 48 
encapsulation 184 
EOF 313 
equal ==49 
escape sequence 2 5 
evaluation 50, 58 

event 229 
adapter 28] 
delegation 229 
interface 230 
listener 281 

source 229 

EventListener Derivations 
286 

exception ??-353 
array 124 
assertion 335, 369 

catch 324-325, 331 
correctness 344 
finally 333 
handling 325 

io 301 

postcondition 335 
precondition 335 

return 330 
throw 325, 335 
throws 328, 336 
try 324-325, 330 

unchecked 336 
Exception class 336 
exceptions 

ArithmeticException 30, 

324 

EOFException 328-329, 
334,336 
Error 336 
ExceptionSub 332 
ExceptionSuper 332 
UlegalMonitorStateExcepti 

on 410 

IndexOutOfBounds 324 
NullPointerException 

324, 358, 364 

RuntimeException 336 
Throwable 336 
exclusive or (bitwise) A 428 


executable image 15 
exponent 28, 426 
export 381 
expression 47 
assignment 47 
boolean 49, 51 
evaluation 58 

infix 370 

method call 47 
extend class 194, 238 
extensibility 184 

F 

falling off the end 85 

false 18-19 

field 26, 165 
final 216 
private 174 
static 170, 216 

figures 

ActionEvent Object 230 
Adding Menus to GUI 276 
Array Layout 121 

Bisection 109 
Button 228 
CoinToss 112 
Command Line 150 
Compilation Process 42 
CRC Card 185 
Defective Copy 127 
Doubly Linked List 367 
Drawing a Rectangle 238 
for Flowchart 66 
Game of Life Blinker 140 
Game of Life Grid 140 
if Flowchart 51 
if-else Flowchart 5 5 
if-else Grouping 59 
inheriting from Parents 

193 

JBuilder 8 
JCheckBox, JFrame, 
JButton GUIs 227 
JComboBox 436 
JScrollPanel 440 
JTextField 438 

List Elements 358 
MiniCalc Box 234 
MiniCalcApplet Screen 

250 

Mouse Clicks on Screen 

284 

Passing an Object 176 
Plot Adjustment 265 
Predator-Prey Class 
Hierarchy 20/ 
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PrintStream Object 170 
Ragged Array Layout 140 
Single linked List 363 
Sorting Algorithm 
Flowchart 53 
Static Variables 170 
Text Input Boxes 232 
Threads and Context 
Switch 396 

Threads and Locks 396 
Three Number Sort 52 
Two Threads Waiting 412 
Type Hierarchy 215 
Widening Conversion 110 

file 299-319 
binary 15, 299 

executable 15 
Java Bytecode 1 5 
machine code 15 
object code 14-15 
redirection 90 
source code 14 
text 299 

File class 313 
final 180, 216 

finally 333 

first-in-first-out 372 

float 19, 28 

floating point type 27-28, 

426 

flow of control 47-72 
flowchart 3 
FlowLayout class 241 
FocusListener class 286 
for statement 65 
initialization 66 
variable 67 
formal assertion 369 
formal parameter 83 
function 
See method 


G 

Game of Life 140 
garbage collection 380 
mark and sweep 380 
reference counting 380 
generic 

container 219 
method 204 
reference 233 
stack 367 
goto 18, 61 

graphical user interface 8, 

227, 259-294 


Graphics class 237, 268, 

270, 293 

greater than >49 
greater than or equal >=49 
GridLayout class 234, 293 
GUI 8, 227, 259-294, 
390 

menu 275 


H 

hand simulation 4 
hardcode 95 
HAS A relationship 217 
header 85 
Heinlein, Robert A. 7 
hierarchy 193, 206 

higher 37 

HTML 249, 252, 299 
tag 249 


I 

IDE 15 

identifier 18, 22 

IEEE 754-1985 426 
if statement 51 
nested 57 

if-else statement 55, 58 

implicit first parameter 166, 

171 

import statement 2 01, 

228, 382 

asterisk * 228 
increment 36 
index 121-122 

exception 124 
loop 87 
zero 153 

infinite loop 64, 68 
Infinity 427 
infix 370 

informal assertion 369 
inheritance 193 
design 217 

HASA relationship 217 
hieracrhy 193 

isa 193 

multiple 215, 217 
Object class 204 
single 217 
superclass 193 

initialization 
array 122 
for statement 66 
two-dimensional array 

139 


while statement 61 
inner block 48 
input 23 

hardcode 95 

numerical 232 
insertion sort 378 
instance 165 
method 165, 171-172, 
197 

variable 165, 178 

instanceof 233 

int 18-19, 27 

integer type 2 7 

Integrated Development 
Environment (IDE) 15 

interface 168, 214, 230, 
263, 281, 294 

extend 216 
iterator 379 
public 214 
Internet 7 
invocation 82, 96 
lOException 301 
ISA relationship 193, 196, 
217 

Itemlistener class 286 
iterator 373, 376 
interface 379 

J 

[Applet class 252 
Java 1, 6, 15 
Bytecode 15 
letter 18 

professional style 38, 72 
project 202, 383 
threads 389-421 
Types Table 18 
Java via the Command Line 

15 

Java via the IDE 15 
java.applet package 250 
java.awt package 227 
java.awt.event package 230 
java.io package 300, 404 
java.lang package 201, 382 
java.net package 404 
javadoc 17, 111 
javax.swing package 227 
JBuilder Figure 8 

JButton class 230, 237, 
435 

JComboBox class 435 
JComponent class 238, 

261 
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[Frame 228 
[Frame class 243 
JLabel class 235, 437 
JList class 436 
JMenuBar class 278, 293 
JMenuItem class 279, 293 
JPanel class 261, 439 
JScrollPanel class 440 
JTextArea class 438 
JTextField class 232, 437 

K 

key 132 
keyboard 301 
KeyListener class 286 
keywords 17 
abstract 214 
boolean 18 

byte 19 

catch 324-325, 331 
char 18, 27 

const 18 

double 18-19, 28 
else 55, 58 
extends 194 

final 180, 216 

finally 333 
float 19, 28 
for 65 

goto 18 

if 51, 55, 58 

import 201, 228, 382 
instanceof 233 

int 18-19, 27 
long 19, 27 

new 122, 168 

package 201, 382 
private 167, 199, 382 

protected 202 

public 83, 167, 199, 
214,252,382 
return 84, 112, 330 
short 19, 27 
static 84, 166, 216 
super 194 
this 178 
throw 335 
throws 328, 336 
try 324-325, 330 
void 83, 97 

while 60 

L 

last-in-first-out 372 
layout manager 234, 293 
length 124 


less than < 49 

less than or equal <=49 
lexical element 16 

library 200, 381 
standard Java 20 
Swing 9 

Linear List Operations 365 

link 358 

linked list stack 359 
listener 230 
adapter 286 
interface 294 
Listening to Button Presses 

231 

lists 

Java via the Command Line 

15 

Java via the IDE 15 
literal 18 
local variable 86 

lock 395 

Logical Operators Table 50 

long 19, 27 

loop 61-62, 64, 69 

index 87 

infinite 64, 68 
termination 63, 91 

M 

machine code 15 
main() method 82 

mantissa 426 
Math class 24, 432 

mean-value theorem 108 
memory recycling 380 
menu GUI 275 

method 14, 24, 81-113, 
165 

abstract 206, 214 

ambiguous call 110 
argument 96 
array 125 
body 82-83 
call 24, 47, 82, 171 

call-by-reference 177 
call-by-value 96 
class 83 

constructor 168 

data member 165 

deferred 206 
deprecate 314 
dynamic dispatch 175, 

197 

generic 204 

header 85 

implicit parameter 166 


instance 171, 197 

instance call 1 / 2 
invocation 82, 96 
library 7 200, 381 
overloading 109, 198 
overriding 193, 196- 
L97 

parameter 24, 83 
passing array to 125 
predefined 24 
pure procedure 84 
recursive 106 
remote invocation 393, 

403 

return type 83-84 
signature 109, 198 
static 83-84, 169-170 

throws 336 
void return 9 7 
methods 

abs() 433 
acosO 432 

actionPerformedO 230- 

231,233,236,277, 
279, 390 

add() 175, 231, 372 

addActionListenerO 230- 

231 

addMouseMotionlistenerO 

244 

ambigO 110 
appendQ 376-378 
asin() 432 
atan() 432 
atan2() 432 

betterLi nearSearchQ 133 
binarySearchO 133 
caesarCipherO 309 
ceil() 433 

clearNeighborCountsO 

209 

click() 207 
cloneO 128 
computeArrayO 153 
computeNeighborsO 210, 

214 

computerMoveO 101 

copyO 126-127, 374- 
375 

copyHelperQ 375 

cos() 240, 432 

CounterO 187 
createGUK) 390 
createTempFileO 313 
crossOutO 136 
currentQ 362, 364, 374 
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drawLineO 240, 264, 

269 

drawOvalO 269 
drawRectO 269 
drawRoundRectO 269 
drawStringO 270 
duplicateO 128 

emptyO 360, 368, 372 
equalsO 204-205 

eval() 371 

exp() 432 
factorial) 107 

flUOvalO 268-269 
flURectO 269 
fillRoundRectO 269 
findRangeO 265 
floorO 433 
get() 398 

getContentPaneO 229, 

231 

getGraphicsO 268 
getMinimumSizeO 239, 

241, 244, 246, 
261-262 

getOffscreenlmageO 246- 

247 

getPreferredSizeO 239, 

241,244,246,254, 
261-262, 264 

getSourceO 233 
getTextO 233 
getUserMoveO 102 
hasMoreElementsO 314 
hasNextO 362, 374 
howManyCopiesOfO 205 
IEEEremainderQ 433 

mit() 250-253 
insertO 361, 363 
IntListlteratorO 374 
isAUHeadsO 95 
isAlphaO 136 
linearSearchO 133 
log() 432 

main() 82 

makeChangeO 172 
max() 86, 433 

maximum© 128 

min() 24, 85, 87, 109, 
130, 433 
minimum© 129 
MinimuinSize© 241 
minMaxArray© 134 
modifyO 176-177 
mouseDraggedO 244- 

245, 248, 253 


mouseMovedO 245, 253 
moveToHeadO 362, 365 
needsDriverEdO 203 

next© 361, 364, 374 
notify© 396, 400, 410- 
411 

notifyAll© 411 

pack© 236, 241 
paint© 239, 246, 264, 
273 

performTrials© 95 
playerMove© 101 
pop© 368, 372 
pow© 432 

print© 24, 198, 300 
printArrayO 129 
printBanner© 89 
printHeadings© 89 
printlnstructions© 101 

println© 24, 198, 300 
printMessage© 82-83 

printRandomNumbers© 

91-92, 153 

printState© 144 
push© 360, 368 
put© 398 

random© 91, 433 
read© 314 

readAndPrintData© 89- 

90 

readArray© 128 
readBinarylnput© 333 
Readlnput© 301 

readlnt© 6, 24, 54, 95 
remove© 362, 364 
rintO 433 
round© 433 

run© 391-392, 394, 
397-398, 408, 411 

sayGoodBye© 106 

set© 207 

setBounds© 262, 264 

setColor© 271 
setFont© 270 
setJMenuBar© 278 
setMnemonic© 278 

setPenSize© 278, 280 
setSize© 266 

sin© 240, 432 
sleep© 392, 410 

sort© 130 

sqrt© 24, 432 
sum© 125, 138 
super© 195, 19/ 
swap© 97, 130, 135 


tan© 432 
toCharArray© 137 
top© 359-360 
toString© 173-174, 
198,200,204,207, 
366 

toStringRecursive© 366 
translate© 270 

trim© 233 
unAmbigO 111 
update© 209 
valueAt© 265 
vignereCipher© 310 

wait© 396, 410 

wordCount© 136 
MI (multiple inheritance) 

217 

minus assignment -= 3 5 
mixed mode arithmetic 30 
mixin 217 
modulus % 31 
modulus assignment 96= 35 
monitor sychronization 399 
Monte Carlo 91 
MouseListener class 285- 
286 

MouseMotionlistener class 

245, 286 

multiline co mm ent /* */ 17 
multiple assignment 34 
multiple inheritance 215, 

217 

multiply * 30 
multiply assignment *= 35 
mutable 126 
mutual exclusion 

synchronization 395 

N 

namespace 200, 381 
naming convention 3 9 
NAN 31, 64, 427 

narrowing primitive 
conversion 32 
native type 184 
negative infinity 427 
nested block 48 
nested if-else 5 7 
network 7, 403 

new 122, 168 

newline \n 2 5 

not! 50 

Not a Number 31, 64 
not equal != 49 
notation 122, 370 


— 
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null 18 

null statement 48 
number 27 
random 91 

numerical bit representation 

425-430 



object 20, 159-188 

array 181 

code 14 

creation 168 
deletion 380 

extends 194 
parameter 177 
passing 175 
pointer 167 
reference 167 


String 20 
Object class 204 
object code 15 
object-oriented 184 
off-by-one 153 
one’s complement 426 
one-dimensional array 121, 


127-128 

one-time nad 310 


OOD 184 

OOP Design Methodology 

222 


operator 19 
assignment 35 
associativity 37-38, 50, 

431 

bitwise 428 
logical 49-50 
precedence 3/-38, 50, 

431 

relational 49 
shift 429 

Operator Precedence and 

Associativity 50, 431 

operators 

(bitwise) and & 428 
< less than 49 
<= less than or equal 49 
> greater than 49 
>= greater than or equal 

49 

and && 50 

and assignment &= 3 5 
assignment = 21, 34 
binary minus - 38 
binary plus +38 

bit 428 


complement (bitwise) ~ 

428 

decrement - 36 
divide assignment /= 3 5 
equal ==49 

exclusive or (bitwise) A 

428 

increment ++36 
min us assignment -= 3 5 
modulus % 31 

modulus assignment %= 

35 

multiply * 3 0 
multiply assignment *= 

35 

new 122 

not! 50 
not equal != 49 
or (bitwise) I 428 
or || 50 

or assignment (exclusive) 

a= 35 

or assignment (inclusive) 

1= 35 

plus assignment +=35 

shift left « 4 3 0 

shift left assignment «= 

35 

shift right assignment »= 

35 

shift right sign extend » 

430 

shift right zero fill >» 

430 

unary minus - 3 8 
unary plus +38 
or (bitwise) | 428 

or || 50 

or assignment (exclusive) A = 

35 

or assignment (inclusive) = 

35 

outer block 48 

output 

parameter 126 

overloading 198 

constructor 168 

method 109 
overriding method 193, 

196-197 

P 

package 200-201, 227, 
380-382 

access 168, 199-200, 
381 


creation 201, 382 
export 381 
namespace 200, 381 
packages 

java.applet 250 
java.awt 227 
java.awt.event 230 
java.io 300, 404 

java.lang 201, 382 
java.net 404 
javax.swing 227 
tio 23 

parameter,24, 83 
array 125 

implicit first 166, 171 

output 126 

this 178 
type list 83 

parentheses () 84, 96, 218 
pixel 237, 429 
plotting data 263 
plus assignment +=35 
Point class 19 

pointer 167, 357 

Polish notation 370 
polymorphism 218 
pure 197 

positive infinity 427 
postcondition 335 
postfix 36 

precedence 19, 37-38 
precondition 335 
Predator-Prey Simulation 

207 

predefined method 24 
prefix 36 

Primitive Conversions Table 

32-33 

primitive type 18 
principle of data hiding 168 
Print Writer class 300 
private 167, 199, 203, 
382 

private field 174 
probability calculation 93 
procedure 
See method 

process 389 
producer 396 
program 14, 389 

fundamentals 13 

robust 324 
style 38, 187 
project 202, 383 

protected 202 

pseudocode 4, 94 
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Advance Generation 141 
Average 61-62 
Average goto 61 
Average Loop 62 
Coin Toss 93 
Computer Move 99 
Console Move 99 
Count Neighbors 208 
Dice 117 
Finding Primes 77 
Game of life 141-142 
Neighbors 142 
One Trial 94 
Polynomial Root 191 
Predator-Prey 208 
Shuffle 183 
Swing event loop 232 
Three Number Sort 52 

Trials 94 

Twenty-One Pickup 98 

User Move 99 
Value 395 

public 83, 167,199, 203, 
214,252,382 

punctuation 19 
pure polymorphism 197 
pure procedure 84 

Q 

qualified name 201, 382 
queue 372 

R 

race condition 396 
Random class 310 
random number 91 
Range of Values for Floating 
Types 28 

Range of Values for Integer 
Types 27 

recursion 106, 375 

recursive data structures 

357 

redirection 90 
reference 167 
generic 233 

type 175 

variable 122, 167 
relational operator 49 
Relational Operators Table 

49 

remote method invocation 

393,403 

reserved word 17 
responsibility 185 


return 83-84, 112, 330 
RMI 394 

robust program 324 
root class 206 

S 

scientific notation 426 
scope 86 

class variable 178 
instance variable 178 
search 

big-oh 134 

binary 133 

selection sort 130-131 
self-documenting code 89 
self-referential structure 

357 

semaphore synchronization 

400 

semicolon 48, 56 
sentinel 62-63, 91 

separator 19 

server 403,407 

ServerSocket class 404 
Shift Bit Operations 430 

shift left« 430 

shift left assignment «= 35 
shift operators 429 
shift right assignment »= 

35 

shift right sign extend » 

430 

shift right zero fill »> 430 

short 19, 27 

short-circuit evaluation 50 
short-circuit-and 430 
SI (single inheritance) 217 

side effect 97, 126 
sieve of Erastophenes 135 
sign extension 429 

signal-wait synchronization 

395 

signature 109, 198 
signed magnitude 426 
Simula 67 207 

simulation 93 

Predator-Prey 207 

single inheritance 217 
single line co mm ent // 17 
singly linked list 361 

Smalltalk 184 
socket 403 

Software Life Cycle 98 
sort 

insertion 378 


key 132 

ordered array 132 
selection 130-13 1 
source code 14 
Special Characters Table 29 

stack 359, 367 

stand-alone application 14 

statement 47-72 
coverage 105 
empty 48 
expression 47 
import 228 

null 48 

variable declaration 47 
statements 

catch 324, 331 

else 55 
for 65 

if 51 

if-else 55, 58 
package 201, 382 
return 84, 112 
throw 335 
try 325, 330 

while 60 

static 84, 166, 169-170, 
216 

field 169 
method 83, 169 

stepwise refinement 81 

storyboard 293 
stream 299-319 
String 18, 20, 30 
array 149 
conversion 303 

string 

control 26 

conversion specification 
26 

String class 18, 366 
stroke 272 

structured control construct 
62 

structured programming 81 

style 38, 187 

array 152 

code reuse 383 
correctness 344 

gui 253 

inheritance 222 
Java professional 72 
story board 293 
structured 81 
synchronization 419 
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subclass 193, 196-19/, 
206, 219 

subscript of array 
See index of array 

subtype principle 197, 

205-206 
super 194 

superclass 193, 195-197, 

219 

Swing 9, 227, 229, 250, 
259-294, 390,435- 
440 

action command 435 
component 227, 234 
container 229 

draw 237, 243 
event 229 
[Frame 228 
listener 230 

thread 390 

synchronization 389, 395 
monitor 397, 399 
semaphor 400 
signal wait 396 


tables 

Array Elements 138 
Assignment Operators 3 5 
Bit Operations 428 
Bit Shift Operations 430 
BufferedReader Input 314 
Character Constants 28 
Elements of array a[i after 

each pass 132 

Eventlistener Derivations 
286 

Exponents 28 
Infinity and NAN 427 
Java Types 18 
Keywords 17 
Logical Operators 50 
Making Change 4 
Math Package Methods 

432 

Narrowing Primitive 
Conversions 33 
Operator Precedence and 
Associativity 38, 50, 

431 

Polish Notation 370 
printfO conversion 
character 26 
Range of Values for 
Floating Types 28 


Range of Values for Integer 
Types 27 

Relational Operators 49 
Special Characters 29 
String Conversions 303 
Widening Primitive 

Conversions 32 

task 389 

testing 105 
bench 4 

branch coverage 105 
statement coverage 105 
text 

clear 309 
file 299 
this 178 
thread 389-421 
AWT 390 

communication 389, 

393 

condition variable 399 
consumer 396 
context switch 395 
creation 391 
critical section 395 
lock 395 

monitor 397, 399 
network 403 
producer 396 

race condition 396 
semaphor 400 
server 407 

signal wait 396 

socket 403 
Swing 390 

synchronization 389, 

395 

timeshare 394 
Thread class 392, 410 
throw 335 
throws 328, 336 
timeshare 394 
tio package 2 3 
token 13, 16 
comment 17 

identifier 18 
keyword 17 
literal 18 
operator 19 

punctuation 19 
white space 16 
top-down design 81, 88 

true 18-19 
try 324-325, 330 

two’s complement 425- 

426 


two-dimensional array 138- 

139 

Two-Stack Polish Notation 

370 

type 

cast reference 2 1 8 

class 19 

constant 180 
data 18-20 
declaration 19 
dynamic 197 
extensibility 1 84 
floating point 27-28 

floating value ranges 28 
hierarchy 206 
identifier 22 
instanceof 233 
integer 27 

integer value ranges 2 7 
Java 18 
literal 18 
native 184 
parameter list 83 
primitive 18 
reference 175 
return 83 

variable 22 
types 

boolean 18 

byte 19 
char 18, 27 
double 18-19, 28 
float 19, 28 
int 18-19, 27 
long 19, 27 
short 19, 27 
String 18, 30 
void 83, 97 

U 

uml 185, 193, 207, 243, 
276, 287 

unary minus - 3 8 
unary plus + 38 
unchecked exception 336 
underscore. 18 

Unicode 300 

Unified Modeling Language 

193 

universal resource locator 8 
URL 8 

user input 2 3 

V 

variable 22 

class 169, 178 







condition 399 
declaration 19, 47 
for statement 67 
instance 165, 178 

local 86 

reference 122, 167 
scope 86 
static 169 
Vemam 310 
Vigenere cipher 309 

void 83, 97 

von Neumann, J. 140 

W 

Web 7 
website xiii 
while statement 60 
initialization 61 
white space 16 
widening conversion 32, 
110 

window 8 

WorkerThread class 407 

Z 

zero 153 

zero extension 429 
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